/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / HENSA / MATHS / PLPLOT / PLPLOT.ZIP / doc / lang.tex

< prev

next >

MacOS 8.1

Win98

DOS

browse contents

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 63 68 61 70 74 65 72 | 7b 50 72 6f 67 72 61 6d |\chapter|{Program|
|00000010| 6d 65 72 20 69 6e 74 65 | 72 66 61 63 65 7d 0a 5c |mer inte|rface}.\|
|00000020| 6c 61 62 65 6c 7b 61 70 | 3a 6c 61 6e 67 7d 0a 0a |label{ap|:lang}..|
|00000030| 25 25 25 25 25 25 25 25 | 25 25 25 25 25 25 25 25 |%%%%%%%%|%%%%%%%%|
|00000040| 25 25 25 25 25 25 25 25 | 25 25 25 25 25 25 25 25 |%%%%%%%%|%%%%%%%%|
|00000050| 25 25 25 25 25 25 25 25 | 25 25 25 25 25 25 25 25 |%%%%%%%%|%%%%%%%%|
|00000060| 25 25 25 25 25 25 25 25 | 25 25 25 25 25 25 25 25 |%%%%%%%%|%%%%%%%%|
|00000070| 25 25 25 25 25 25 25 25 | 25 25 25 25 25 0a 5c 73 |%%%%%%%%|%%%%%.\s|
|00000080| 65 63 74 69 6f 6e 20 7b | 43 20 6c 61 6e 67 75 61 |ection {|C langua|
|00000090| 67 65 7d 0a 0a 54 68 65 | 20 61 72 67 75 6d 65 6e |ge}..The| argumen|
|000000a0| 74 20 74 79 70 65 73 20 | 67 69 76 65 6e 20 69 6e |t types |given in|
|000000b0| 20 74 68 69 73 20 6d 61 | 6e 75 61 6c 20 28 50 4c | this ma|nual (PL|
|000000c0| 46 4c 54 20 61 6e 64 20 | 50 4c 49 4e 54 29 20 61 |FLT and |PLINT) a|
|000000d0| 72 65 20 74 79 70 65 64 | 65 66 73 20 66 6f 72 0a |re typed|efs for.|
|000000e0| 74 68 65 20 61 63 74 75 | 61 6c 20 61 72 67 75 6d |the actu|al argum|
|000000f0| 65 6e 74 20 74 79 70 65 | 2e 20 20 41 20 50 4c 49 |ent type|.  A PLI|
|00000100| 4e 54 20 69 73 20 61 63 | 74 75 61 6c 6c 79 20 61 |NT is ac|tually a|
|00000110| 20 74 79 70 65 20 7b 5c | 74 74 20 6c 6f 6e 67 7d | type {\|tt long}|
|00000120| 20 61 6e 64 20 73 68 6f | 75 6c 64 0a 6e 6f 74 20 | and sho|uld.not |
|00000130| 62 65 20 63 68 61 6e 67 | 65 64 2e 20 20 41 20 50 |be chang|ed.  A P|
|00000140| 4c 46 4c 54 20 63 61 6e | 20 62 65 20 65 69 74 68 |LFLT can| be eith|
|00000150| 65 72 20 61 20 7b 5c 74 | 74 20 66 6c 6f 61 74 7d |er a {\t|t float}|
|00000160| 20 6f 72 20 7b 5c 74 74 | 20 64 6f 75 62 6c 65 7d | or {\tt| double}|
|00000170| 3b 20 74 68 69 73 0a 63 | 68 6f 69 63 65 20 69 73 |; this.c|hoice is|
|00000180| 20 6d 61 64 65 20 77 68 | 65 6e 20 74 68 65 20 70 | made wh|en the p|
|00000190| 61 63 6b 61 67 65 20 69 | 73 20 69 6e 73 74 61 6c |ackage i|s instal|
|000001a0| 6c 65 64 20 61 6e 64 20 | 6f 6e 20 61 20 55 6e 69 |led and |on a Uni|
|000001b0| 78 20 73 79 73 74 65 6d | 20 28 66 6f 72 0a 65 78 |x system| (for.ex|
|000001c0| 61 6d 70 6c 65 29 20 6d | 61 79 20 72 65 73 75 6c |ample) m|ay resul|
|000001d0| 74 20 69 6e 20 61 20 50 | 4c 70 6c 6f 74 20 6c 69 |t in a P|Lplot li|
|000001e0| 62 72 61 72 79 20 6e 61 | 6d 65 64 20 7b 5c 74 74 |brary na|med {\tt|
|000001f0| 20 6c 69 62 70 6c 70 6c | 6f 74 66 2e 61 7d 20 69 | libplpl|otf.a} i|
|00000200| 6e 20 73 69 6e 67 6c 65 | 0a 70 72 65 63 69 73 69 |n single|.precisi|
|00000210| 6f 6e 20 61 6e 64 20 7b | 5c 74 74 20 6c 69 62 70 |on and {|\tt libp|
|00000220| 6c 70 6c 6f 74 64 2e 61 | 7d 20 69 6e 20 64 6f 75 |lplotd.a|} in dou|
|00000230| 62 6c 65 20 70 72 65 63 | 69 73 69 6f 6e 2e 0a 0a |ble prec|ision...|
|00000240| 54 68 65 73 65 20 61 6e | 64 20 6f 74 68 65 72 20 |These an|d other |
|00000250| 63 6f 6e 73 74 61 6e 74 | 73 20 75 73 65 64 20 62 |constant|s used b|
|00000260| 79 20 50 4c 70 6c 6f 74 | 20 61 72 65 20 64 65 66 |y PLplot| are def|
|00000270| 69 6e 65 64 20 69 6e 20 | 74 68 65 20 6d 61 69 6e |ined in |the main|
|00000280| 20 68 65 61 64 65 72 20 | 66 69 6c 65 0a 7b 5c 74 | header |file.{\t|
|00000290| 74 20 70 6c 70 6c 6f 74 | 2e 68 7d 2c 20 77 68 69 |t plplot|.h}, whi|
|000002a0| 63 68 20 6d 75 73 74 20 | 62 65 20 69 6e 63 6c 75 |ch must |be inclu|
|000002b0| 64 65 64 20 62 79 20 74 | 68 65 20 75 73 65 72 20 |ded by t|he user |
|000002c0| 70 72 6f 67 72 61 6d 2e | 20 20 54 68 69 73 20 66 |program.|  This f|
|000002d0| 69 6c 65 20 61 6c 73 6f | 0a 63 6f 6e 74 61 69 6e |ile also|.contain|
|000002e0| 73 20 61 6c 6c 20 6f 66 | 20 74 68 65 20 66 75 6e |s all of| the fun|
|000002f0| 63 74 69 6f 6e 20 70 72 | 6f 74 6f 74 79 70 65 73 |ction pr|ototypes|
|00000300| 2c 20 6d 61 63 68 69 6e | 65 20 64 65 70 65 6e 64 |, machin|e depend|
|00000310| 65 6e 74 20 64 65 66 69 | 6e 65 73 2c 20 61 6e 64 |ent defi|nes, and|
|00000320| 0a 72 65 64 65 66 69 6e | 69 74 69 6f 6e 20 6f 66 |.redefin|ition of|
|00000330| 20 74 68 65 20 43 2d 6c | 61 6e 67 75 61 67 65 20 | the C-l|anguage |
|00000340| 62 69 6e 64 69 6e 67 73 | 20 74 68 61 74 20 63 6f |bindings| that co|
|00000350| 6e 66 6c 69 63 74 20 77 | 69 74 68 20 74 68 65 20 |nflict w|ith the |
|00000360| 46 6f 72 74 72 61 6e 20 | 6e 61 6d 65 73 0a 28 6d |Fortran |names.(m|
|00000370| 6f 72 65 20 6f 6e 20 74 | 68 69 73 20 6c 61 74 65 |ore on t|his late|
|00000380| 72 29 2e 20 20 7b 5c 74 | 74 20 70 6c 70 6c 6f 74 |r).  {\t|t plplot|
|00000390| 2e 68 7d 20 6f 62 74 61 | 69 6e 73 20 69 74 73 20 |.h} obta|ins its |
|000003a0| 76 61 6c 75 65 73 20 66 | 6f 72 20 50 4c 46 4c 54 |values f|or PLFLT|
|000003b0| 2c 20 50 4c 49 4e 54 2c | 0a 61 6e 64 20 50 4c 41 |, PLINT,|.and PLA|
|000003c0| 52 47 53 20 28 61 20 6d | 61 63 72 6f 20 66 6f 72 |RGS (a m|acro for|
|000003d0| 20 63 6f 6e 64 69 74 69 | 6f 6e 61 6c 6c 79 20 67 | conditi|onally g|
|000003e0| 65 6e 65 72 61 74 69 6e | 67 20 70 72 6f 74 6f 74 |eneratin|g protot|
|000003f0| 79 70 65 20 61 72 67 75 | 6d 65 6e 74 20 6c 69 73 |ype argu|ment lis|
|00000400| 74 73 29 0a 66 72 6f 6d | 20 46 4c 4f 41 54 20 28 |ts).from| FLOAT (|
|00000410| 74 79 70 65 64 65 66 29 | 2c 20 49 4e 54 20 28 74 |typedef)|, INT (t|
|00000420| 79 70 65 64 65 66 29 2c | 20 61 6e 64 20 50 52 4f |ypedef),| and PRO|
|00000430| 54 4f 20 28 6d 61 63 72 | 6f 29 2c 20 72 65 73 70 |TO (macr|o), resp|
|00000440| 65 63 74 69 76 65 6c 79 | 2e 0a 54 68 65 20 6c 61 |ectively|..The la|
|00000450| 74 74 65 72 20 61 72 65 | 20 64 65 66 69 6e 65 64 |tter are| defined|
|00000460| 20 69 6e 20 74 68 65 20 | 66 69 6c 65 0a 7b 5c 74 | in the |file.{\t|
|00000470| 74 20 63 68 64 72 2e 68 | 7d 2e 20 20 54 68 65 20 |t chdr.h|}.  The |
|00000480| 75 73 65 72 20 69 73 20 | 65 6e 63 6f 75 72 61 67 |user is |encourag|
|00000490| 65 64 20 74 6f 20 75 73 | 65 20 46 4c 4f 41 54 2c |ed to us|e FLOAT,|
|000004a0| 20 49 4e 54 2c 20 61 6e | 64 20 50 52 4f 54 4f 20 | INT, an|d PROTO |
|000004b0| 69 6e 0a 68 69 73 2f 68 | 65 72 20 6f 77 6e 20 63 |in.his/h|er own c|
|000004c0| 6f 64 65 2c 20 61 6e 64 | 20 6d 6f 64 69 66 79 20 |ode, and| modify |
|000004d0| 7b 5c 74 74 20 63 68 64 | 72 2e 68 7d 20 61 63 63 |{\tt chd|r.h} acc|
|000004e0| 6f 72 64 69 6e 67 20 74 | 6f 20 74 61 73 74 65 2e |ording t|o taste.|
|000004f0| 20 20 49 74 20 69 73 20 | 6e 6f 74 0a 61 63 74 75 |  It is |not.actu|
|00000500| 61 6c 6c 79 20 6e 65 63 | 65 73 73 61 72 79 20 74 |ally nec|essary t|
|00000510| 6f 20 64 65 63 6c 61 72 | 65 20 76 61 72 69 61 62 |o declar|e variab|
|00000520| 6c 65 73 20 61 73 20 46 | 4c 4f 41 54 20 61 6e 64 |les as F|LOAT and|
|00000530| 20 49 4e 54 20 65 78 63 | 65 70 74 20 77 68 65 6e | INT exc|ept when|
|00000540| 20 74 68 65 79 0a 61 72 | 65 20 70 6f 69 6e 74 65 | they.ar|e pointe|
|00000550| 72 73 2c 20 61 73 20 61 | 75 74 6f 6d 61 74 69 63 |rs, as a|utomatic|
|00000560| 20 63 6f 6e 76 65 72 73 | 69 6f 6e 20 74 6f 20 74 | convers|ion to t|
|00000570| 68 65 20 72 69 67 68 74 | 20 74 79 70 65 20 77 69 |he right| type wi|
|00000580| 6c 6c 20 6f 74 68 65 72 | 77 69 73 65 20 6f 63 63 |ll other|wise occ|
|00000590| 75 72 0a 28 69 66 20 75 | 73 69 6e 67 20 61 20 53 |ur.(if u|sing a S|
|000005a0| 74 61 6e 64 61 72 64 20 | 43 20 63 6f 6d 70 69 6c |tandard |C compil|
|000005b0| 65 72 3b 20 65 6c 73 65 | 20 4b 5c 26 52 20 73 74 |er; else| K\&R st|
|000005c0| 79 6c 65 20 61 75 74 6f | 6d 61 74 69 63 20 70 72 |yle auto|matic pr|
|000005d0| 6f 6d 6f 74 69 6f 6e 20 | 77 69 6c 6c 0a 6f 63 63 |omotion |will.occ|
|000005e0| 75 72 29 2e 20 20 54 68 | 65 20 6f 6e 6c 79 20 63 |ur).  Th|e only c|
|000005f0| 6f 64 65 20 69 6e 20 7b | 5c 74 74 20 70 6c 70 6c |ode in {|\tt plpl|
|00000600| 6f 74 2e 68 7d 20 74 68 | 61 74 20 64 69 72 65 63 |ot.h} th|at direc|
|00000610| 74 6c 79 20 64 65 70 65 | 6e 64 73 20 6f 6e 20 74 |tly depe|nds on t|
|00000620| 68 65 73 65 0a 73 65 74 | 74 69 6e 67 73 20 69 73 |hese.set|tings is|
|00000630| 20 61 73 20 66 6f 6c 6c | 6f 77 73 3a 0a 5c 62 65 | as foll|ows:.\be|
|00000640| 67 69 6e 7b 76 65 72 62 | 61 74 69 6d 7d 0a 23 69 |gin{verb|atim}.#i|
|00000650| 6e 63 6c 75 64 65 20 22 | 63 68 64 72 2e 68 22 0a |nclude "|chdr.h".|
|00000660| 0a 2f 2a 20 63 68 61 6e | 67 65 20 66 72 6f 6d 20 |./* chan|ge from |
|00000670| 63 68 64 72 2e 68 20 63 | 6f 6e 76 65 6e 74 69 6f |chdr.h c|onventio|
|00000680| 6e 73 20 74 6f 20 70 6c | 70 6c 6f 74 20 6f 6e 65 |ns to pl|plot one|
|00000690| 73 20 2a 2f 0a 0a 74 79 | 70 65 64 65 66 20 46 4c |s */..ty|pedef FL|
|000006a0| 4f 41 54 20 50 4c 46 4c | 54 3b 0a 74 79 70 65 64 |OAT PLFL|T;.typed|
|000006b0| 65 66 20 49 4e 54 20 20 | 20 50 4c 49 4e 54 3b 0a |ef INT  | PLINT;.|
|000006c0| 23 64 65 66 69 6e 65 20 | 50 4c 41 52 47 53 28 61 |#define |PLARGS(a|
|000006d0| 29 20 50 52 4f 54 4f 28 | 61 29 0a 5c 65 6e 64 7b |) PROTO(|a).\end{|
|000006e0| 76 65 72 62 61 74 69 6d | 7d 0a 0a 50 4c 70 6c 6f |verbatim|}..PLplo|
|000006f0| 74 20 69 73 20 63 61 70 | 61 62 6c 65 20 6f 66 20 |t is cap|able of |
|00000700| 62 65 69 6e 67 20 63 6f | 6d 70 69 6c 65 64 20 77 |being co|mpiled w|
|00000710| 69 74 68 20 53 74 61 6e | 64 61 72 64 20 43 20 28 |ith Stan|dard C (|
|00000720| 41 4e 53 49 29 20 6d 6f | 64 65 20 6f 6e 20 6f 72 |ANSI) mo|de on or|
|00000730| 20 6f 66 66 2e 0a 54 68 | 69 73 20 69 73 20 74 6f | off..Th|is is to|
|00000740| 67 67 6c 65 64 20 76 69 | 61 20 74 68 65 20 6d 61 |ggled vi|a the ma|
|00000750| 63 72 6f 20 50 4c 53 54 | 44 43 2c 20 61 6e 64 20 |cro PLST|DC, and |
|00000760| 73 65 74 20 61 75 74 6f | 6d 61 74 69 63 61 6c 6c |set auto|maticall|
|00000770| 79 20 69 66 20 5c 5f 5c | 5f 53 54 44 43 5c 5f 5c |y if \_\|_STDC\_\|
|00000780| 5f 0a 69 73 20 64 65 66 | 69 6e 65 64 2e 20 20 49 |_.is def|ined.  I|
|00000790| 66 20 50 4c 53 54 44 43 | 20 69 73 20 64 65 66 69 |f PLSTDC| is defi|
|000007a0| 6e 65 64 2c 20 61 6c 6c | 20 66 75 6e 63 74 69 6f |ned, all| functio|
|000007b0| 6e 73 20 61 72 65 20 70 | 72 6f 74 6f 74 79 70 65 |ns are p|rototype|
|000007c0| 64 20 61 73 20 61 6c 6c | 6f 77 65 64 0a 75 6e 64 |d as all|owed.und|
|000007d0| 65 72 20 53 74 61 6e 64 | 61 72 64 20 43 2c 20 61 |er Stand|ard C, a|
|000007e0| 6e 64 20 61 72 67 75 6d | 65 6e 74 73 20 70 61 73 |nd argum|ents pas|
|000007f0| 73 65 64 20 65 78 61 63 | 74 6c 79 20 61 73 20 73 |sed exac|tly as s|
|00000800| 70 65 63 69 66 69 65 64 | 20 69 6e 20 74 68 65 0a |pecified| in the.|
|00000810| 70 72 6f 74 6f 74 79 70 | 65 2e 20 20 49 66 20 50 |prototyp|e.  If P|
|00000820| 4c 53 54 44 43 20 69 73 | 20 6e 6f 74 20 64 65 66 |LSTDC is| not def|
|00000830| 69 6e 65 64 2c 20 68 6f | 77 65 76 65 72 2c 20 66 |ined, ho|wever, f|
|00000840| 75 6e 63 74 69 6f 6e 20 | 70 72 6f 74 6f 74 79 70 |unction |prototyp|
|00000850| 65 73 20 61 72 65 0a 74 | 75 72 6e 65 64 20 6f 66 |es are.t|urned of|
|00000860| 66 20 61 6e 64 20 4b 5c | 26 52 20 61 75 74 6f 6d |f and K\|&R autom|
|00000870| 61 74 69 63 20 61 72 67 | 75 6d 65 6e 74 20 70 72 |atic arg|ument pr|
|00000880| 6f 6d 6f 74 69 6f 6e 20 | 77 69 6c 6c 20 6f 63 63 |omotion |will occ|
|00000890| 75 72 2c 20 65 2e 67 2e | 20 20 7b 5c 74 74 0a 66 |ur, e.g.|  {\tt.f|
|000008a0| 6c 6f 61 74 20 24 5c 72 | 61 72 24 20 64 6f 75 62 |loat $\r|ar$ doub|
|000008b0| 6c 65 2c 20 69 6e 74 20 | 24 5c 72 61 72 24 20 6c |le, int |$\rar$ l|
|000008c0| 6f 6e 67 7d 2e 20 20 54 | 68 65 72 65 20 69 73 20 |ong}.  T|here is |
|000008d0| 6e 6f 20 6d 69 64 64 6c | 65 20 67 72 6f 75 6e 64 |no middl|e ground|
|000008e0| 21 20 20 41 20 50 4c 70 | 6c 6f 74 0a 6c 69 62 72 |!  A PLp|lot.libr|
|000008f0| 61 72 79 20 62 75 69 6c | 74 20 77 69 74 68 20 50 |ary buil|t with P|
|00000900| 4c 53 54 44 43 20 64 65 | 66 69 6e 65 64 20 77 69 |LSTDC de|fined wi|
|00000910| 6c 6c 20 6e 6f 74 20 77 | 6f 72 6b 20 28 69 6e 20 |ll not w|ork (in |
|00000920| 67 65 6e 65 72 61 6c 29 | 20 77 69 74 68 20 61 20 |general)| with a |
|00000930| 70 72 6f 67 72 61 6d 0a | 62 75 69 6c 74 20 77 69 |program.|built wi|
|00000940| 74 68 20 50 4c 53 54 44 | 43 20 75 6e 64 65 66 69 |th PLSTD|C undefi|
|00000950| 6e 65 64 2c 20 61 6e 64 | 20 76 69 63 65 20 76 65 |ned, and| vice ve|
|00000960| 72 73 61 2e 20 20 49 74 | 20 69 73 20 70 6f 73 73 |rsa.  It| is poss|
|00000970| 69 62 6c 65 20 69 6e 20 | 70 72 69 6e 63 69 70 6c |ible in |principl|
|00000980| 65 20 74 6f 0a 62 75 69 | 6c 64 20 61 20 6c 69 62 |e to.bui|ld a lib|
|00000990| 72 61 72 79 20 74 68 61 | 74 20 77 69 6c 6c 20 77 |rary tha|t will w|
|000009a0| 6f 72 6b 20 75 6e 64 65 | 72 20 62 6f 74 68 20 53 |ork unde|r both S|
|000009b0| 74 61 6e 64 61 72 64 20 | 43 20 61 6e 64 20 4b 5c |tandard |C and K\|
|000009c0| 26 52 20 63 6f 6d 70 69 | 6c 65 72 73 0a 73 69 6d |&R compi|lers.sim|
|000009d0| 75 6c 74 61 6e 65 6f 75 | 73 6c 79 20 28 69 2e 65 |ultaneou|sly (i.e|
|000009e0| 2e 20 20 62 79 20 64 75 | 70 6c 69 63 61 74 69 6e |.  by du|plicatin|
|000009f0| 67 20 74 68 65 20 4b 5c | 26 52 20 70 72 6f 6d 6f |g the K\|&R promo|
|00000a00| 74 69 6f 6e 20 77 69 74 | 68 20 74 68 65 20 53 74 |tion wit|h the St|
|00000a10| 61 6e 64 61 72 64 20 43 | 0a 70 72 6f 74 6f 74 79 |andard C|.prototy|
|00000a20| 70 65 29 2c 20 62 75 74 | 20 74 68 69 73 20 73 65 |pe), but| this se|
|00000a30| 65 6d 73 20 74 6f 20 76 | 69 6f 6c 61 74 65 20 74 |ems to v|iolate t|
|00000a40| 68 65 20 73 70 69 72 69 | 74 20 6f 66 20 74 68 65 |he spiri|t of the|
|00000a50| 20 43 20 73 74 61 6e 64 | 61 72 64 20 61 6e 64 20 | C stand|ard and |
|00000a60| 63 61 6e 0a 62 65 20 63 | 6f 6e 66 75 73 69 6e 67 |can.be c|onfusing|
|00000a70| 2e 20 20 45 76 65 6e 74 | 75 61 6c 6c 79 20 77 65 |.  Event|ually we|
|00000a80| 20 77 69 6c 6c 20 64 72 | 6f 70 20 73 75 70 70 6f | will dr|op suppo|
|00000a90| 72 74 20 66 6f 72 20 6e | 6f 6e 2d 73 74 61 6e 64 |rt for n|on-stand|
|00000aa0| 61 72 64 20 43 20 63 6f | 6d 70 69 6c 65 72 73 20 |ard C co|mpilers |
|00000ab0| 0a 62 75 74 20 66 6f 72 | 20 6e 6f 77 20 68 61 76 |.but for| now hav|
|00000ac0| 65 20 61 64 6f 70 74 65 | 64 20 74 68 69 73 20 63 |e adopte|d this c|
|00000ad0| 6f 6d 70 72 6f 6d 69 73 | 65 2e 0a 0a 49 6e 20 73 |ompromis|e...In s|
|00000ae0| 75 6d 6d 61 72 79 2c 20 | 50 4c 70 6c 6f 74 20 77 |ummary, |PLplot w|
|00000af0| 69 6c 6c 20 77 6f 72 6b | 20 75 73 69 6e 67 20 65 |ill work| using e|
|00000b00| 69 74 68 65 72 20 61 20 | 53 74 61 6e 64 61 72 64 |ither a |Standard|
|00000b10| 20 6f 72 20 6e 6f 6e 2d | 73 74 61 6e 64 61 72 64 | or non-|standard|
|00000b20| 20 43 0a 63 6f 6d 70 69 | 6c 65 72 2c 20 70 72 6f | C.compi|ler, pro|
|00000b30| 76 69 64 65 64 20 74 68 | 61 74 20 79 6f 75 20 3a |vided th|at you :|
|00000b40| 0a 5c 62 65 67 69 6e 7b | 65 6e 75 6d 65 72 61 74 |.\begin{|enumerat|
|00000b50| 65 7d 0a 5c 69 74 65 6d | 20 49 6e 63 6c 75 64 65 |e}.\item| Include|
|00000b60| 20 74 68 65 20 50 4c 70 | 6c 6f 74 20 6d 61 69 6e | the PLp|lot main|
|00000b70| 20 68 65 61 64 65 72 20 | 66 69 6c 65 20 7b 5c 74 | header |file {\t|
|00000b80| 74 20 70 6c 70 6c 6f 74 | 2e 68 7d 2e 0a 5c 69 74 |t plplot|.h}..\it|
|00000b90| 65 6d 20 4d 61 6b 65 20 | 73 75 72 65 20 61 6c 6c |em Make |sure all|
|00000ba0| 20 70 6f 69 6e 74 65 72 | 20 61 72 67 75 6d 65 6e | pointer| argumen|
|00000bb0| 74 73 20 61 72 65 20 6f | 66 20 74 68 65 20 63 6f |ts are o|f the co|
|00000bc0| 72 72 65 63 74 20 74 79 | 70 65 0a 28 74 68 65 20 |rrect ty|pe.(the |
|00000bd0| 63 6f 6d 70 69 6c 65 72 | 20 73 68 6f 75 6c 64 20 |compiler| should |
|00000be0| 77 61 72 6e 20 79 6f 75 | 20 69 66 20 79 6f 75 20 |warn you| if you |
|00000bf0| 66 6f 72 67 65 74 2c 20 | 73 6f 20 64 6f 6e 27 74 |forget, |so don't|
|00000c00| 20 77 6f 72 72 79 2c 20 | 62 65 20 68 61 70 70 79 | worry, |be happy|
|00000c10| 29 2e 0a 5c 69 74 65 6d | 20 44 6f 20 6e 6f 74 20 |)..\item| Do not |
|00000c20| 6c 69 6e 6b 20 61 20 63 | 6f 64 65 20 63 6f 6d 70 |link a c|ode comp|
|00000c30| 69 6c 65 64 20 77 69 74 | 68 20 50 4c 53 54 44 43 |iled wit|h PLSTDC|
|00000c40| 20 64 65 66 69 6e 65 64 | 20 74 6f 20 61 20 50 4c | defined| to a PL|
|00000c50| 70 6c 6f 74 20 6c 69 62 | 72 61 72 79 0a 63 6f 6d |plot lib|rary.com|
|00000c60| 70 69 6c 65 64 20 77 69 | 74 68 20 50 4c 53 54 44 |piled wi|th PLSTD|
|00000c70| 43 20 75 6e 64 65 66 69 | 6e 65 64 2c 20 6f 72 20 |C undefi|ned, or |
|00000c80| 76 69 63 65 20 76 65 72 | 73 61 2e 0a 5c 69 74 65 |vice ver|sa..\ite|
|00000c90| 6d 20 55 73 65 20 70 72 | 6f 74 6f 74 79 70 65 73 |m Use pr|ototypes|
|00000ca0| 20 77 68 65 6e 65 76 65 | 72 20 70 6f 73 73 69 62 | wheneve|r possib|
|00000cb0| 6c 65 20 74 6f 20 72 65 | 64 75 63 65 20 74 79 70 |le to re|duce typ|
|00000cc0| 65 20 65 72 72 6f 72 73 | 2e 0a 5c 65 6e 64 7b 65 |e errors|..\end{e|
|00000cd0| 6e 75 6d 65 72 61 74 65 | 7d 0a 0a 4e 6f 74 65 20 |numerate|}..Note |
|00000ce0| 74 68 61 74 20 73 6f 6d | 65 20 53 74 61 6e 64 61 |that som|e Standa|
|00000cf0| 72 64 20 43 20 63 6f 6d | 70 69 6c 65 72 73 20 77 |rd C com|pilers w|
|00000d00| 69 6c 6c 20 67 69 76 65 | 20 77 61 72 6e 69 6e 67 |ill give| warning|
|00000d10| 73 20 77 68 65 6e 20 63 | 6f 6e 76 65 72 74 69 6e |s when c|onvertin|
|00000d20| 67 20 61 0a 63 6f 6e 73 | 74 61 6e 74 20 66 75 6e |g a.cons|tant fun|
|00000d30| 63 74 69 6f 6e 20 61 72 | 67 75 6d 65 6e 74 20 74 |ction ar|gument t|
|00000d40| 6f 20 77 68 61 74 65 76 | 65 72 20 69 73 20 72 65 |o whatev|er is re|
|00000d50| 71 75 69 72 65 64 20 62 | 79 20 74 68 65 20 70 72 |quired b|y the pr|
|00000d60| 6f 74 6f 74 79 70 65 2e | 20 20 54 68 65 73 65 0a |ototype.|  These.|
|00000d70| 77 61 72 6e 69 6e 67 73 | 20 63 61 6e 20 62 65 20 |warnings| can be |
|00000d80| 69 67 6e 6f 72 65 64 2e | 0a 0a 54 68 65 20 6f 6e |ignored.|..The on|
|00000d90| 65 20 61 64 64 69 74 69 | 6f 6e 61 6c 20 63 6f 6d |e additi|onal com|
|00000da0| 70 6c 69 63 61 74 69 6e | 67 20 66 61 63 74 6f 72 |plicatin|g factor|
|00000db0| 20 63 6f 6e 63 65 72 6e | 73 20 74 68 65 20 75 73 | concern|s the us|
|00000dc0| 65 20 6f 66 20 73 74 75 | 62 20 72 6f 75 74 69 6e |e of stu|b routin|
|00000dd0| 65 73 20 74 6f 0a 69 6e | 74 65 72 66 61 63 65 20 |es to.in|terface |
|00000de0| 77 69 74 68 20 46 6f 72 | 74 72 61 6e 20 28 73 65 |with For|tran (se|
|00000df0| 65 20 74 68 65 20 66 6f | 6c 6c 6f 77 69 6e 67 20 |e the fo|llowing |
|00000e00| 73 65 63 74 69 6f 6e 20 | 66 6f 72 20 6d 6f 72 65 |section |for more|
|00000e10| 20 65 78 70 6c 61 6e 61 | 74 69 6f 6e 29 2e 20 20 | explana|tion).  |
|00000e20| 4f 6e 0a 73 6f 6d 65 20 | 73 79 73 74 65 6d 73 2c |On.some |systems,|
|00000e30| 20 74 68 65 20 46 6f 72 | 74 72 61 6e 20 5c 26 20 | the For|tran \& |
|00000e40| 43 20 6e 61 6d 65 73 70 | 61 63 65 73 20 61 72 65 |C namesp|aces are|
|00000e50| 20 73 65 74 20 75 70 20 | 74 6f 20 63 6c 6f 62 62 | set up |to clobb|
|00000e60| 65 72 20 65 61 63 68 20 | 6f 74 68 65 72 2e 0a 4d |er each |other..M|
|00000e70| 6f 72 65 20 72 65 61 73 | 6f 6e 61 62 6c 65 20 28 |ore reas|onable (|
|00000e80| 66 72 6f 6d 20 6f 75 72 | 20 76 69 65 77 70 6f 69 |from our| viewpoi|
|00000e90| 6e 74 29 20 69 73 20 74 | 6f 20 61 67 72 65 65 20 |nt) is t|o agree |
|00000ea0| 6f 6e 20 61 20 73 74 61 | 6e 64 61 72 64 20 6d 61 |on a sta|ndard ma|
|00000eb0| 70 20 62 65 74 77 65 65 | 6e 0a 6e 61 6d 65 73 70 |p betwee|n.namesp|
|00000ec0| 61 63 65 73 2c 20 73 75 | 63 68 20 61 73 20 74 68 |aces, su|ch as th|
|00000ed0| 65 20 61 70 70 65 6e 64 | 69 6e 67 20 6f 66 20 61 |e append|ing of a|
|00000ee0| 6e 20 75 6e 64 65 72 73 | 63 6f 72 65 20 74 6f 20 |n unders|core to |
|00000ef0| 46 6f 72 74 72 61 6e 20 | 72 6f 75 74 69 6e 65 20 |Fortran |routine |
|00000f00| 6e 61 6d 65 73 0a 61 73 | 20 69 73 20 63 6f 6d 6d |names.as| is comm|
|00000f10| 6f 6e 20 6f 6e 20 6d 61 | 6e 79 20 55 6e 69 78 2d |on on ma|ny Unix-|
|00000f20| 6c 69 6b 65 20 73 79 73 | 74 65 6d 73 2e 20 20 54 |like sys|tems.  T|
|00000f30| 68 65 20 6f 6e 6c 79 20 | 63 61 73 65 20 77 68 65 |he only |case whe|
|00000f40| 72 65 20 74 68 65 20 73 | 68 61 72 65 64 0a 46 6f |re the s|hared.Fo|
|00000f50| 72 74 72 61 6e 2f 43 20 | 6e 61 6d 65 73 70 61 63 |rtran/C |namespac|
|00000f60| 65 73 20 64 6f 20 61 6e | 79 20 67 6f 6f 64 20 69 |es do an|y good i|
|00000f70| 73 20 77 68 65 6e 20 70 | 61 73 73 69 6e 67 20 61 |s when p|assing a|
|00000f80| 20 70 6f 69 6e 74 65 72 | 20 74 6f 20 61 20 6c 69 | pointer| to a li|
|00000f90| 6b 65 20 64 61 74 61 0a | 74 79 70 65 2c 20 77 68 |ke data.|type, wh|
|00000fa0| 69 63 68 20 72 65 70 72 | 65 73 65 6e 74 73 20 6f |ich repr|esents o|
|00000fb0| 6e 6c 79 20 61 20 73 6d | 61 6c 6c 20 66 72 61 63 |nly a sm|all frac|
|00000fc0| 74 69 6f 6e 20 6f 66 20 | 74 68 65 20 63 61 73 65 |tion of |the case|
|00000fd0| 73 20 74 68 61 74 20 6e | 65 65 64 20 74 6f 0a 62 |s that n|eed to.b|
|00000fe0| 65 20 68 61 6e 64 6c 65 | 64 20 28 77 68 69 63 68 |e handle|d (which|
|00000ff0| 20 69 6e 63 6c 75 64 65 | 73 20 63 6f 6e 73 74 61 | include|s consta|
|00001000| 6e 74 20 76 61 6c 75 65 | 73 20 70 61 73 73 65 64 |nt value|s passed|
|00001010| 20 6f 6e 20 74 68 65 20 | 73 74 61 63 6b 2c 20 73 | on the |stack, s|
|00001020| 74 72 69 6e 67 73 2c 20 | 61 6e 64 0a 74 77 6f 2d |trings, |and.two-|
|00001030| 64 69 6d 65 6e 73 69 6f | 6e 61 6c 20 61 72 72 61 |dimensio|nal arra|
|00001040| 79 73 29 2e 0a 0a 54 68 | 65 72 65 20 61 72 65 20 |ys)...Th|ere are |
|00001050| 73 65 76 65 72 61 6c 20 | 77 61 79 73 20 74 6f 20 |several |ways to |
|00001060| 64 65 61 6c 20 77 69 74 | 68 20 74 68 69 73 20 73 |deal wit|h this s|
|00001070| 69 74 75 61 74 69 6f 6e | 2c 20 62 75 74 20 74 68 |ituation|, but th|
|00001080| 65 20 6c 65 61 73 74 20 | 6d 65 73 73 79 20 66 72 |e least |messy fr|
|00001090| 6f 6d 0a 61 20 75 73 65 | 72 27 73 20 70 65 72 73 |om.a use|r's pers|
|000010a0| 70 65 63 74 69 76 65 20 | 69 73 20 74 6f 20 72 65 |pective |is to re|
|000010b0| 64 65 66 69 6e 65 20 74 | 68 6f 73 65 20 50 4c 70 |define t|hose PLp|
|000010c0| 6c 6f 74 20 43 20 66 75 | 6e 63 74 69 6f 6e 20 6e |lot C fu|nction n|
|000010d0| 61 6d 65 73 20 77 68 69 | 63 68 0a 63 6f 6e 66 6c |ames whi|ch.confl|
|000010e0| 69 63 74 20 77 69 74 68 | 20 74 68 65 20 46 6f 72 |ict with| the For|
|000010f0| 74 72 61 6e 2d 69 6e 74 | 65 72 66 61 63 65 20 73 |tran-int|erface s|
|00001100| 74 75 62 20 72 6f 75 74 | 69 6e 65 73 2e 20 20 54 |tub rout|ines.  T|
|00001110| 68 65 20 61 63 74 75 61 | 6c 20 66 75 6e 63 74 69 |he actua|l functi|
|00001120| 6f 6e 0a 6e 61 6d 65 73 | 20 61 72 65 20 74 68 65 |on.names| are the|
|00001130| 20 73 61 6d 65 20 61 73 | 20 74 68 6f 73 65 20 64 | same as| those d|
|00001140| 65 73 63 72 69 62 65 64 | 20 69 6e 20 74 68 69 73 |escribed| in this|
|00001150| 20 64 6f 63 75 6d 65 6e | 74 2c 20 62 75 74 20 77 | documen|t, but w|
|00001160| 69 74 68 20 61 20 60 60 | 63 5c 5f 27 27 0a 70 72 |ith a ``|c\_''.pr|
|00001170| 65 70 65 6e 64 65 64 2e | 20 20 54 68 65 73 65 20 |epended.|  These |
|00001180| 6d 61 63 72 6f 20 64 65 | 66 69 6e 69 74 69 6f 6e |macro de|finition|
|00001190| 73 20 61 70 70 65 61 72 | 20 69 6e 20 74 68 65 20 |s appear| in the |
|000011a0| 7b 5c 74 74 20 70 6c 70 | 6c 6f 74 2e 68 7d 20 68 |{\tt plp|lot.h} h|
|000011b0| 65 61 64 65 72 20 66 69 | 6c 65 0a 61 6e 64 20 61 |eader fi|le.and a|
|000011c0| 72 65 20 6f 74 68 65 72 | 77 69 73 65 20 68 61 72 |re other|wise har|
|000011d0| 6d 6c 65 73 73 2e 20 20 | 54 68 65 72 65 66 6f 72 |mless.  |Therefor|
|000011e0| 65 20 79 6f 75 20 63 61 | 6e 20 28 61 6e 64 20 73 |e you ca|n (and s|
|000011f0| 68 6f 75 6c 64 29 20 66 | 6f 72 67 65 74 20 74 68 |hould) f|orget th|
|00001200| 61 74 20 6d 6f 73 74 0a | 6f 66 20 74 68 65 20 6e |at most.|of the n|
|00001210| 61 6d 65 73 20 61 72 65 | 20 62 65 69 6e 67 20 72 |ames are| being r|
|00001220| 65 64 65 66 69 6e 65 64 | 20 74 6f 20 61 76 6f 69 |edefined| to avoi|
|00001230| 64 20 74 68 65 20 63 6f | 6e 66 6c 69 63 74 20 61 |d the co|nflict a|
|00001240| 6e 64 20 73 69 6d 70 6c | 79 20 61 64 68 65 72 65 |nd simpl|y adhere|
|00001250| 20 74 6f 0a 74 68 65 20 | 62 69 6e 64 69 6e 67 73 | to.the |bindings|
|00001260| 20 61 73 20 64 65 73 63 | 72 69 62 65 64 20 69 6e | as desc|ribed in|
|00001270| 20 74 68 69 73 20 6d 61 | 6e 75 61 6c 2e 20 20 43 | this ma|nual.  C|
|00001280| 6f 64 65 73 20 77 72 69 | 74 74 65 6e 20 75 6e 64 |odes wri|tten und|
|00001290| 65 72 20 6f 6c 64 20 76 | 65 72 73 69 6f 6e 73 0a |er old v|ersions.|
|000012a0| 6f 66 20 50 4c 70 6c 6f | 74 20 28 70 72 65 76 69 |of PLplo|t (previ|
|000012b0| 6f 75 73 20 74 6f 20 34 | 2e 30 29 20 77 69 6c 6c |ous to 4|.0) will|
|000012c0| 20 72 65 71 75 69 72 65 | 20 61 20 72 65 63 6f 6d | require| a recom|
|000012d0| 70 69 6c 65 2c 20 68 6f | 77 65 76 65 72 2e 0a 0a |pile, ho|wever...|
|000012e0| 49 74 20 69 73 20 70 6f | 73 73 69 62 6c 65 20 74 |It is po|ssible t|
|000012f0| 6f 20 63 6f 6d 70 69 6c | 65 20 74 68 65 20 50 4c |o compil|e the PL|
|00001300| 70 6c 6f 74 20 6c 69 62 | 72 61 72 79 20 73 6f 20 |plot lib|rary so |
|00001310| 74 68 61 74 20 74 68 65 | 20 61 66 66 65 63 74 65 |that the| affecte|
|00001320| 64 20 66 75 6e 63 74 69 | 6f 6e 73 0a 72 65 74 61 |d functi|ons.reta|
|00001330| 69 6e 20 74 68 65 69 72 | 20 64 6f 63 75 6d 65 6e |in their| documen|
|00001340| 74 65 64 20 6e 61 6d 65 | 73 2c 20 62 79 20 73 70 |ted name|s, by sp|
|00001350| 65 63 69 66 79 69 6e 67 | 20 7b 5c 74 74 20 2d 44 |ecifying| {\tt -D|
|00001360| 4e 4f 42 52 41 49 4e 44 | 45 41 44 7d 20 6f 6e 20 |NOBRAIND|EAD} on |
|00001370| 74 68 65 0a 63 6f 6d 70 | 69 6c 65 20 6c 69 6e 65 |the.comp|ile line|
|00001380| 2e 20 20 53 6f 6d 65 20 | 72 65 61 73 6f 6e 73 20 |.  Some |reasons |
|00001390| 66 6f 72 20 64 6f 69 6e | 67 20 74 68 69 73 20 6d |for doin|g this m|
|000013a0| 69 67 68 74 20 62 65 3a | 20 20 28 61 29 20 79 6f |ight be:|  (a) yo|
|000013b0| 75 20 64 6f 6e 27 74 20 | 77 61 6e 74 20 74 6f 0a |u don't |want to.|
|000013c0| 69 6e 63 6c 75 64 65 20 | 7b 5c 74 74 20 70 6c 70 |include |{\tt plp|
|000013d0| 6c 6f 74 2e 68 7d 20 69 | 6e 74 6f 20 79 6f 75 72 |lot.h} i|nto your|
|000013e0| 20 70 72 6f 67 72 61 6d | 20 66 6f 72 20 77 68 61 | program| for wha|
|000013f0| 74 65 76 65 72 20 72 65 | 61 73 6f 6e 2c 20 6f 72 |tever re|ason, or|
|00001400| 20 28 62 29 20 79 6f 75 | 20 61 72 65 0a 64 65 62 | (b) you| are.deb|
|00001410| 75 67 67 69 6e 67 20 50 | 4c 70 6c 6f 74 20 61 6e |ugging P|Lplot an|
|00001420| 64 20 77 69 73 68 20 74 | 6f 20 73 70 65 63 69 66 |d wish t|o specif|
|00001430| 79 20 74 68 65 20 64 6f | 63 75 6d 65 6e 74 65 64 |y the do|cumented|
|00001440| 20 6e 61 6d 65 73 20 74 | 6f 20 74 68 65 20 64 65 | names t|o the de|
|00001450| 62 75 67 67 65 72 2e 0a | 49 6e 20 66 61 63 74 20 |bugger..|In fact |
|00001460| 74 68 69 73 20 70 72 6f | 63 65 64 75 72 65 20 77 |this pro|cedure w|
|00001470| 69 6c 6c 20 77 6f 72 6b | 20 66 69 6e 65 20 75 6e |ill work| fine un|
|00001480| 64 65 72 20 53 55 4e 4f | 53 2c 20 77 69 74 68 20 |der SUNO|S, with |
|00001490| 6e 6f 20 46 6f 72 74 72 | 61 6e 2f 43 0a 6e 61 6d |no Fortr|an/C.nam|
|000014a0| 65 73 70 61 63 65 20 63 | 6f 6c 6c 69 73 69 6f 6e |espace c|ollision|
|000014b0| 2e 20 20 42 75 74 20 6f | 6e 20 6f 74 68 65 72 20 |.  But o|n other |
|000014c0| 73 79 73 74 65 6d 73 20 | 61 20 73 70 65 63 69 61 |systems |a specia|
|000014d0| 6c 20 63 6f 6d 70 69 6c | 65 72 20 73 77 69 74 63 |l compil|er switc|
|000014e0| 68 20 6d 61 79 20 62 65 | 0a 72 65 71 75 69 72 65 |h may be|.require|
|000014f0| 64 20 74 6f 20 67 65 74 | 20 69 74 20 74 6f 20 77 |d to get| it to w|
|00001500| 6f 72 6b 20 73 69 6d 69 | 6c 61 72 6c 79 2c 20 77 |ork simi|larly, w|
|00001510| 68 69 63 68 20 69 73 20 | 61 6e 20 65 78 74 72 61 |hich is |an extra|
|00001520| 20 62 75 72 64 65 6e 20 | 6f 6e 20 74 68 65 20 75 | burden |on the u|
|00001530| 73 65 72 0a 61 6e 64 20 | 62 65 73 74 20 61 76 6f |ser.and |best avo|
|00001540| 69 64 65 64 2e 0a 0a 46 | 6f 72 20 6d 6f 72 65 20 |ided...F|or more |
|00001550| 69 6e 66 6f 72 6d 61 74 | 69 6f 6e 20 6f 6e 20 63 |informat|ion on c|
|00001560| 61 6c 6c 69 6e 67 20 50 | 4c 70 6c 6f 74 20 66 72 |alling P|Lplot fr|
|00001570| 6f 6d 20 43 2c 20 70 6c | 65 61 73 65 20 73 65 65 |om C, pl|ease see|
|00001580| 20 74 68 65 20 31 34 20 | 65 78 61 6d 70 6c 65 20 | the 14 |example |
|00001590| 43 0a 70 72 6f 67 72 61 | 6d 73 20 28 7b 5c 74 74 |C.progra|ms ({\tt|
|000015a0| 20 78 30 31 63 2e 63 7d | 20 74 68 72 6f 75 67 68 | x01c.c}| through|
|000015b0| 20 7b 5c 74 74 20 78 31 | 34 63 2e 63 7d 29 20 64 | {\tt x1|4c.c}) d|
|000015c0| 69 73 74 72 69 62 75 74 | 65 64 20 77 69 74 68 20 |istribut|ed with |
|000015d0| 50 4c 70 6c 6f 74 2e 0a | 0a 25 25 25 25 25 25 25 |PLplot..|.%%%%%%%|
|000015e0| 25 25 25 25 25 25 25 25 | 25 25 25 25 25 25 25 25 |%%%%%%%%|%%%%%%%%|
|000015f0| 25 25 25 25 25 25 25 25 | 25 25 25 25 25 25 25 25 |%%%%%%%%|%%%%%%%%|
|00001600| 25 25 25 25 25 25 25 25 | 25 25 25 25 25 25 25 25 |%%%%%%%%|%%%%%%%%|
|00001610| 25 25 25 25 25 25 25 25 | 25 25 25 25 25 25 25 25 |%%%%%%%%|%%%%%%%%|
|00001620| 25 25 25 25 25 25 0a 5c | 73 65 63 74 69 6f 6e 20 |%%%%%%.\|section |
|00001630| 7b 46 6f 72 74 72 61 6e | 20 6c 61 6e 67 75 61 67 |{Fortran| languag|
|00001640| 65 7d 0a 0a 41 73 20 64 | 69 73 63 75 73 73 65 64 |e}..As d|iscussed|
|00001650| 20 69 6e 20 74 68 65 20 | 70 72 65 63 65 64 69 6e | in the |precedin|
|00001660| 67 20 73 65 63 74 69 6f | 6e 2c 20 50 4c 70 6c 6f |g sectio|n, PLplo|
|00001670| 74 27 73 20 69 6e 74 65 | 67 65 72 20 72 65 70 72 |t's inte|ger repr|
|00001680| 65 73 65 6e 74 61 74 69 | 6f 6e 20 69 73 20 61 0a |esentati|on is a.|
|00001690| 50 4c 49 4e 54 20 61 6e | 64 20 69 74 73 20 66 6c |PLINT an|d its fl|
|000016a0| 6f 61 74 69 6e 67 20 70 | 6f 69 6e 74 20 72 65 70 |oating p|oint rep|
|000016b0| 72 65 73 65 6e 74 61 74 | 69 6f 6e 20 69 73 20 61 |resentat|ion is a|
|000016c0| 20 50 4c 46 4c 54 2e 20 | 20 54 6f 20 74 68 65 0a | PLFLT. | To the.|
|000016d0| 46 6f 72 74 72 61 6e 20 | 75 73 65 72 2c 20 74 68 |Fortran |user, th|
|000016e0| 69 73 20 6d 6f 73 74 20 | 63 6f 6d 6d 6f 6e 6c 79 |is most |commonly|
|000016f0| 20 74 72 61 6e 73 6c 61 | 74 65 73 20 74 6f 20 61 | transla|tes to a|
|00001700| 20 74 79 70 65 20 7b 5c | 74 74 20 69 6e 74 65 67 | type {\|tt integ|
|00001710| 65 72 7d 20 61 6e 64 0a | 74 79 70 65 20 7b 5c 74 |er} and.|type {\t|
|00001720| 74 20 72 65 61 6c 7d 2c | 20 72 65 73 70 65 63 74 |t real},| respect|
|00001730| 69 76 65 6c 79 2e 20 20 | 54 68 69 73 20 69 73 20 |ively.  |This is |
|00001740| 73 6f 6d 65 77 68 61 74 | 20 73 79 73 74 65 6d 20 |somewhat| system |
|00001750| 64 65 70 65 6e 64 65 6e | 74 20 28 61 6e 64 20 75 |dependen|t (and u|
|00001760| 70 20 74 6f 0a 74 68 65 | 20 69 6e 73 74 61 6c 6c |p to.the| install|
|00001770| 65 72 20 6f 66 20 74 68 | 65 20 70 61 63 6b 61 67 |er of th|e packag|
|00001780| 65 29 20 73 6f 20 79 6f | 75 20 73 68 6f 75 6c 64 |e) so yo|u should|
|00001790| 20 63 68 65 63 6b 20 74 | 68 65 20 72 65 6c 65 61 | check t|he relea|
|000017a0| 73 65 20 6e 6f 74 65 73 | 20 74 6f 20 62 65 0a 73 |se notes| to be.s|
|000017b0| 75 72 65 2c 20 6f 72 20 | 6a 75 73 74 20 74 72 79 |ure, or |just try|
|000017c0| 20 69 74 20 61 6e 64 20 | 73 65 65 20 77 68 61 74 | it and |see what|
|000017d0| 20 68 61 70 70 65 6e 73 | 2e 0a 0a 42 65 63 61 75 | happens|...Becau|
|000017e0| 73 65 20 74 68 65 20 50 | 4c 70 6c 6f 74 20 6b 65 |se the P|Lplot ke|
|000017f0| 72 6e 65 6c 20 69 73 20 | 77 72 69 74 74 65 6e 20 |rnel is |written |
|00001800| 69 6e 20 43 2c 20 73 74 | 61 6e 64 61 72 64 20 43 |in C, st|andard C|
|00001810| 20 73 79 6e 74 61 78 20 | 69 73 20 75 73 65 64 20 | syntax |is used |
|00001820| 69 6e 20 74 68 65 0a 64 | 65 73 63 72 69 70 74 69 |in the.d|escripti|
|00001830| 6f 6e 20 6f 66 20 65 61 | 63 68 20 50 4c 70 6c 6f |on of ea|ch PLplo|
|00001840| 74 20 66 75 6e 63 74 69 | 6f 6e 2e 20 20 54 68 75 |t functi|on.  Thu|
|00001850| 73 20 74 6f 20 75 6e 64 | 65 72 73 74 61 6e 64 20 |s to und|erstand |
|00001860| 74 68 69 73 20 6d 61 6e | 75 61 6c 20 69 74 20 69 |this man|ual it i|
|00001870| 73 0a 68 65 6c 70 66 75 | 6c 20 74 6f 20 6b 6e 6f |s.helpfu|l to kno|
|00001880| 77 20 61 20 6c 69 74 74 | 6c 65 20 61 62 6f 75 74 |w a litt|le about|
|00001890| 20 43 2c 20 62 75 74 20 | 66 6f 72 74 75 6e 61 74 | C, but |fortunat|
|000018a0| 65 6c 79 20 74 68 65 20 | 74 72 61 6e 73 6c 61 74 |ely the |translat|
|000018b0| 69 6f 6e 20 69 73 20 76 | 65 72 79 0a 65 61 73 79 |ion is v|ery.easy|
|000018c0| 20 61 6e 64 20 63 61 6e | 20 62 65 20 73 75 6d 6d | and can| be summ|
|000018d0| 61 72 69 7a 65 64 20 68 | 65 72 65 2e 20 20 41 73 |arized h|ere.  As|
|000018e0| 20 61 6e 20 65 78 61 6d | 70 6c 65 2c 20 74 68 65 | an exam|ple, the|
|000018f0| 20 72 6f 75 74 69 6e 65 | 20 7b 5c 74 74 20 70 6c | routine| {\tt pl|
|00001900| 6c 69 6e 65 7d 0a 63 61 | 6c 6c 20 66 72 6f 6d 20 |line}.ca|ll from |
|00001910| 43 20 77 6f 75 6c 64 20 | 6c 6f 6f 6b 20 6c 69 6b |C would |look lik|
|00001920| 65 3a 0a 25 0a 5c 62 65 | 67 69 6e 7b 76 65 72 62 |e:.%.\be|gin{verb|
|00001930| 61 74 69 6d 7d 0a 20 20 | 20 20 70 6c 6c 69 6e 65 |atim}.  |  plline|
|00001940| 28 6e 2c 78 2c 79 29 3b | 7d 0a 5c 65 6e 64 7b 76 |(n,x,y);|}.\end{v|
|00001950| 65 72 62 61 74 69 6d 7d | 0a 25 0a 77 68 69 6c 65 |erbatim}|.%.while|
|00001960| 20 66 72 6f 6d 20 46 6f | 72 74 72 61 6e 20 77 6f | from Fo|rtran wo|
|00001970| 75 6c 64 20 6c 6f 6f 6b | 20 6c 69 6b 65 3a 0a 25 |uld look| like:.%|
|00001980| 0a 5c 62 65 67 69 6e 7b | 76 65 72 62 61 74 69 6d |.\begin{|verbatim|
|00001990| 7d 0a 09 63 61 6c 6c 20 | 70 6c 6c 69 6e 65 28 6e |}..call |plline(n|
|000019a0| 2c 78 2c 79 29 0a 5c 65 | 6e 64 7b 76 65 72 62 61 |,x,y).\e|nd{verba|
|000019b0| 74 69 6d 7d 0a 25 0a 74 | 79 70 69 63 61 6c 6c 79 |tim}.%.t|ypically|
|000019c0| 20 77 69 74 68 20 7b 5c | 74 74 20 6e 7d 20 64 65 | with {\|tt n} de|
|000019d0| 63 6c 61 72 65 64 20 61 | 73 20 74 79 70 65 20 7b |clared a|s type {|
|000019e0| 5c 74 74 20 69 6e 74 65 | 67 65 72 7d 20 61 6e 64 |\tt inte|ger} and|
|000019f0| 20 7b 5c 74 74 20 78 7d | 2c 20 7b 5c 74 74 20 79 | {\tt x}|, {\tt y|
|00001a00| 7d 0a 64 65 63 6c 61 72 | 65 64 20 61 73 20 74 79 |}.declar|ed as ty|
|00001a10| 70 65 20 7b 5c 74 74 20 | 72 65 61 6c 7d 20 28 61 |pe {\tt |real} (a|
|00001a20| 72 72 61 79 73 20 69 6e | 20 74 68 69 73 20 63 61 |rrays in| this ca|
|00001a30| 73 65 29 2e 20 20 45 61 | 63 68 20 43 20 6c 61 6e |se).  Ea|ch C lan|
|00001a40| 67 75 61 67 65 20 74 79 | 70 65 0a 75 73 65 64 20 |guage ty|pe.used |
|00001a50| 69 6e 20 74 68 65 20 74 | 65 78 74 20 74 72 61 6e |in the t|ext tran|
|00001a60| 73 6c 61 74 65 73 20 72 | 6f 75 67 68 6c 79 20 61 |slates r|oughly a|
|00001a70| 73 20 66 6f 6c 6c 6f 77 | 73 3a 0a 5c 62 65 67 69 |s follow|s:.\begi|
|00001a80| 6e 7b 74 61 62 62 69 6e | 67 7d 0a 30 31 32 33 34 |n{tabbin|g}.01234|
|00001a90| 35 36 37 5c 3d 0a 09 38 | 39 30 31 32 33 34 35 36 |567\=..8|90123456|
|00001aa0| 37 38 39 30 31 32 33 34 | 35 36 37 38 39 30 31 5c |78901234|5678901\|
|00001ab0| 3d 5c 6b 69 6c 6c 0a 25 | 0a 09 5c 3e 50 4c 46 4c |=\kill.%|..\>PLFL|
|00001ac0| 54 09 09 09 5c 3e 72 65 | 61 6c 5c 5c 0a 09 5c 3e |T...\>re|al\\..\>|
|00001ad0| 50 4c 49 4e 54 09 09 09 | 5c 3e 69 6e 74 65 67 65 |PLINT...|\>intege|
|00001ae0| 72 5c 5c 0a 09 5c 3e 63 | 68 61 72 20 2a 09 09 5c |r\\..\>c|har *..\|
|00001af0| 3e 63 68 61 72 61 63 74 | 65 72 5c 5c 0a 09 5c 3e |>charact|er\\..\>|
|00001b00| 50 4c 46 4c 54 20 2a 09 | 09 5c 3e 72 65 61 6c 20 |PLFLT *.|.\>real |
|00001b10| 6f 72 20 72 65 61 6c 20 | 61 72 72 61 79 5c 5c 0a |or real |array\\.|
|00001b20| 09 5c 3e 50 4c 46 4c 54 | 20 2a 2a 09 09 5c 3e 72 |.\>PLFLT| **..\>r|
|00001b30| 65 61 6c 20 61 72 72 61 | 79 5c 5c 0a 09 5c 3e 7b |eal arra|y\\..\>{|
|00001b40| 5c 74 74 22 7d 73 74 72 | 69 6e 67 7b 5c 74 74 22 |\tt"}str|ing{\tt"|
|00001b50| 7d 09 5c 3e 7b 5c 74 74 | 27 7d 73 74 72 69 6e 67 |}.\>{\tt|'}string|
|00001b60| 7b 5c 74 74 27 7d 5c 5c | 0a 09 5c 3e 61 72 72 61 |{\tt'}\\|..\>arra|
|00001b70| 79 5b 30 5d 09 09 5c 3e | 61 72 72 61 79 28 31 29 |y[0]..\>|array(1)|
|00001b80| 5c 5c 0a 5c 65 6e 64 7b | 74 61 62 62 69 6e 67 7d |\\.\end{|tabbing}|
|00001b90| 0a 49 6e 20 43 20 74 68 | 65 72 65 20 61 72 65 20 |.In C th|ere are |
|00001ba0| 74 77 6f 20 77 61 79 73 | 20 74 6f 20 70 61 73 73 |two ways| to pass|
|00001bb0| 20 61 20 76 61 72 69 61 | 62 6c 65 20 2d 2d 2d 20 | a varia|ble --- |
|00001bc0| 62 79 20 76 61 6c 75 65 | 20 28 74 68 65 20 64 65 |by value| (the de|
|00001bd0| 66 61 75 6c 74 29 20 6f | 72 20 62 79 0a 72 65 66 |fault) o|r by.ref|
|00001be0| 65 72 65 6e 63 65 20 28 | 70 6f 69 6e 74 65 72 29 |erence (|pointer)|
|00001bf0| 2c 20 77 68 65 72 65 61 | 73 20 6f 6e 6c 79 20 74 |, wherea|s only t|
|00001c00| 68 65 20 6c 61 74 74 65 | 72 20 69 73 20 75 73 65 |he latte|r is use|
|00001c10| 64 20 62 79 20 46 6f 72 | 74 72 61 6e 2e 0a 54 68 |d by For|tran..Th|
|00001c20| 65 72 65 66 6f 72 65 20 | 77 68 65 6e 20 79 6f 75 |erefore |when you|
|00001c30| 20 73 65 65 20 72 65 66 | 65 72 65 6e 63 65 73 20 | see ref|erences |
|00001c40| 69 6e 20 74 68 65 20 74 | 65 78 74 20 74 6f 20 7b |in the t|ext to {|
|00001c50| 5c 65 6d 20 65 69 74 68 | 65 72 7d 20 61 6e 20 6f |\em eith|er} an o|
|00001c60| 72 64 69 6e 61 72 79 0a | 61 72 67 75 6d 65 6e 74 |rdinary.|argument|
|00001c70| 20 6f 72 20 61 20 70 6f | 69 6e 74 65 72 20 61 72 | or a po|inter ar|
|00001c80| 67 75 6d 65 6e 74 20 28 | 65 2e 67 2e 20 20 7b 5c |gument (|e.g.  {\|
|00001c90| 74 74 20 2a 64 61 74 61 | 7d 29 2c 20 79 6f 75 20 |tt *data|}), you |
|00001ca0| 73 69 6d 70 6c 79 20 75 | 73 65 20 61 6e 0a 6f 72 |simply u|se an.or|
|00001cb0| 64 69 6e 61 72 79 20 46 | 6f 72 74 72 61 6e 20 76 |dinary F|ortran v|
|00001cc0| 61 72 69 61 62 6c 65 20 | 6f 72 20 61 72 72 61 79 |ariable |or array|
|00001cd0| 20 6e 61 6d 65 2e 0a 0a | 54 68 65 20 50 4c 70 6c | name...|The PLpl|
|00001ce0| 6f 74 20 6c 69 62 72 61 | 72 79 20 63 6f 6d 65 73 |ot libra|ry comes|
|00001cf0| 20 77 69 74 68 20 61 20 | 73 65 74 20 6f 66 20 46 | with a |set of F|
|00001d00| 6f 72 74 72 61 6e 20 69 | 6e 74 65 72 66 61 63 65 |ortran i|nterface|
|00001d10| 20 72 6f 75 74 69 6e 65 | 73 20 74 68 61 74 0a 61 | routine|s that.a|
|00001d20| 6c 6c 6f 77 20 74 68 65 | 20 65 78 61 63 74 20 73 |llow the| exact s|
|00001d30| 61 6d 65 20 63 61 6c 6c | 20 73 79 6e 74 61 78 20 |ame call| syntax |
|00001d40| 28 75 73 75 61 6c 6c 79 | 29 20 72 65 67 61 72 64 |(usually|) regard|
|00001d50| 6c 65 73 73 20 6f 66 20 | 77 68 65 74 68 65 72 20 |less of |whether |
|00001d60| 63 61 6c 6c 69 6e 67 0a | 66 72 6f 6d 20 43 20 6f |calling.|from C o|
|00001d70| 72 20 46 6f 72 74 72 61 | 6e 2e 20 20 49 6e 20 73 |r Fortra|n.  In s|
|00001d80| 6f 6d 65 20 63 61 73 65 | 73 2c 20 74 68 69 73 20 |ome case|s, this |
|00001d90| 6d 65 61 6e 73 20 74 68 | 65 20 73 75 62 72 6f 75 |means th|e subrou|
|00001da0| 74 69 6e 65 20 6e 61 6d | 65 20 7b 5c 65 6d 0a 65 |tine nam|e {\em.e|
|00001db0| 78 63 65 65 64 73 20 38 | 20 63 68 61 72 61 63 74 |xceeds 8| charact|
|00001dc0| 65 72 73 20 69 6e 20 6c | 65 6e 67 74 68 7d 2e 20 |ers in l|ength}. |
|00001dd0| 20 4e 65 61 72 6c 79 20 | 65 76 65 72 79 20 46 6f | Nearly |every Fo|
|00001de0| 72 74 72 61 6e 20 63 6f | 6d 70 69 6c 65 72 20 6f |rtran co|mpiler o|
|00001df0| 6e 20 73 61 6c 65 0a 74 | 6f 64 61 79 20 61 6c 6c |n sale.t|oday all|
|00001e00| 6f 77 73 20 73 75 62 72 | 6f 75 74 69 6e 65 20 6e |ows subr|outine n|
|00001e10| 61 6d 65 73 20 6c 6f 6e | 67 65 72 20 74 68 61 6e |ames lon|ger than|
|00001e20| 20 38 20 63 68 61 72 61 | 63 74 65 72 73 2c 20 73 | 8 chara|cters, s|
|00001e30| 6f 20 74 68 69 73 20 73 | 68 6f 75 6c 64 20 6e 6f |o this s|hould no|
|00001e40| 74 0a 62 65 20 61 20 70 | 72 6f 62 6c 65 6d 20 28 |t.be a p|roblem (|
|00001e50| 61 6c 74 68 6f 75 67 68 | 20 69 66 20 69 74 20 65 |although| if it e|
|00001e60| 76 65 72 20 69 73 2c 20 | 69 6e 20 70 72 69 6e 63 |ver is, |in princ|
|00001e70| 69 70 6c 65 20 61 20 74 | 72 75 6e 63 61 74 65 64 |iple a t|runcated|
|00001e80| 20 6e 61 6d 65 20 63 6f | 75 6c 64 0a 62 65 20 64 | name co|uld.be d|
|00001e90| 65 66 69 6e 65 64 20 66 | 6f 72 20 74 68 61 74 20 |efined f|or that |
|00001ea0| 70 6c 61 74 66 6f 72 6d | 29 2e 0a 0a 54 68 65 73 |platform|)...Thes|
|00001eb0| 65 20 60 60 73 74 75 62 | 27 27 20 72 6f 75 74 69 |e ``stub|'' routi|
|00001ec0| 6e 65 73 20 68 61 6e 64 | 6c 65 20 74 72 61 6e 73 |nes hand|le trans|
|00001ed0| 66 6f 72 6d 69 6e 67 20 | 74 68 65 20 64 61 74 61 |forming |the data|
|00001ee0| 0a 66 72 6f 6d 20 74 68 | 65 20 6e 6f 72 6d 61 6c |.from th|e normal|
|00001ef0| 20 46 6f 72 74 72 61 6e | 20 72 65 70 72 65 73 65 | Fortran| represe|
|00001f00| 6e 74 61 74 69 6f 6e 20 | 74 6f 20 74 68 61 74 20 |ntation |to that |
|00001f10| 74 79 70 69 63 61 6c 6c | 79 20 75 73 65 64 20 69 |typicall|y used i|
|00001f20| 6e 20 43 2e 20 20 54 68 | 69 73 0a 69 6e 63 6c 75 |n C.  Th|is.inclu|
|00001f30| 64 65 73 3a 0a 5c 62 65 | 67 69 6e 7b 65 6e 75 6d |des:.\be|gin{enum|
|00001f40| 65 72 61 74 65 7d 0a 5c | 69 74 65 6d 20 56 61 72 |erate}.\|item Var|
|00001f50| 69 61 62 6c 65 73 20 70 | 61 73 73 65 64 20 62 79 |iables p|assed by|
|00001f60| 20 76 61 6c 75 65 20 69 | 6e 73 74 65 61 64 20 6f | value i|nstead o|
|00001f70| 66 20 62 79 20 72 65 66 | 65 72 65 6e 63 65 2e 0a |f by ref|erence..|
|00001f80| 0a 46 6f 72 74 72 61 6e | 20 70 61 73 73 65 73 20 |.Fortran| passes |
|00001f90| 61 6c 6c 20 73 75 62 72 | 6f 75 74 69 6e 65 20 61 |all subr|outine a|
|00001fa0| 72 67 75 6d 65 6e 74 73 | 20 62 79 20 72 65 66 65 |rguments| by refe|
|00001fb0| 72 65 6e 63 65 2c 20 69 | 2e 65 2e 7e 61 20 70 6f |rence, i|.e.~a po|
|00001fc0| 69 6e 74 65 72 20 74 6f | 20 74 68 65 0a 61 72 67 |inter to| the.arg|
|00001fd0| 75 6d 65 6e 74 20 76 61 | 6c 75 65 20 69 73 20 70 |ument va|lue is p|
|00001fe0| 75 73 68 65 64 20 6f 6e | 20 74 68 65 20 73 74 61 |ushed on| the sta|
|00001ff0| 63 6b 2e 20 20 49 6e 20 | 43 20 61 6c 6c 20 76 61 |ck.  In |C all va|
|00002000| 6c 75 65 73 2c 20 65 78 | 63 65 70 74 20 66 6f 72 |lues, ex|cept for|
|00002010| 20 61 72 72 61 79 73 0a | 28 69 6e 63 6c 75 64 69 | arrays.|(includi|
|00002020| 6e 67 20 63 68 61 72 20 | 61 72 72 61 79 73 29 2c |ng char |arrays),|
|00002030| 20 61 72 65 20 70 61 73 | 73 65 64 20 62 79 20 76 | are pas|sed by v|
|00002040| 61 6c 75 65 2c 20 69 2e | 65 2e 7e 74 68 65 20 61 |alue, i.|e.~the a|
|00002050| 72 67 75 6d 65 6e 74 20 | 76 61 6c 75 65 0a 69 74 |rgument |value.it|
|00002060| 73 65 6c 66 20 69 73 20 | 70 75 73 68 65 64 20 6f |self is |pushed o|
|00002070| 6e 20 74 68 65 20 73 74 | 61 63 6b 2e 20 20 54 68 |n the st|ack.  Th|
|00002080| 65 20 73 74 75 62 20 72 | 6f 75 74 69 6e 65 20 63 |e stub r|outine c|
|00002090| 6f 6e 76 65 72 74 73 20 | 74 68 65 20 46 6f 72 74 |onverts |the Fort|
|000020a0| 72 61 6e 20 63 61 6c 6c | 0a 62 79 20 72 65 66 65 |ran call|.by refe|
|000020b0| 72 65 6e 63 65 20 74 6f | 20 61 20 63 61 6c 6c 20 |rence to| a call |
|000020c0| 62 79 20 76 61 6c 75 65 | 2e 20 20 41 73 20 61 6e |by value|.  As an|
|000020d0| 20 65 78 61 6d 70 6c 65 | 2c 20 68 65 72 65 20 69 | example|, here i|
|000020e0| 73 20 68 6f 77 20 74 68 | 65 20 70 6c 70 6f 69 6e |s how th|e plpoin|
|000020f0| 20 73 74 75 62 0a 72 6f | 75 74 69 6e 65 20 77 6f | stub.ro|utine wo|
|00002100| 72 6b 73 2e 20 20 49 6e | 20 79 6f 75 72 20 46 6f |rks.  In| your Fo|
|00002110| 72 74 72 61 6e 20 70 72 | 6f 67 72 61 6d 20 79 6f |rtran pr|ogram yo|
|00002120| 75 20 6d 69 67 68 74 20 | 68 61 76 65 20 61 20 63 |u might |have a c|
|00002130| 61 6c 6c 20 74 6f 20 70 | 6c 70 6f 69 6e 20 74 68 |all to p|lpoin th|
|00002140| 61 74 0a 6c 6f 6f 6b 73 | 20 73 6f 6d 65 74 68 69 |at.looks| somethi|
|00002150| 6e 67 20 6c 69 6b 65 0a | 5c 62 65 67 69 6e 7b 76 |ng like.|\begin{v|
|00002160| 65 72 62 61 74 69 6d 7d | 0a 20 20 20 20 20 20 63 |erbatim}|.      c|
|00002170| 61 6c 6c 20 70 6c 70 6f | 69 6e 28 36 2c 78 2c 79 |all plpo|in(6,x,y|
|00002180| 2c 39 29 0a 5c 65 6e 64 | 7b 76 65 72 62 61 74 69 |,9).\end|{verbati|
|00002190| 6d 7d 0a 0a 77 68 65 72 | 65 20 78 20 61 6e 64 20 |m}..wher|e x and |
|000021a0| 79 20 61 72 65 20 61 72 | 72 61 79 73 20 77 69 74 |y are ar|rays wit|
|000021b0| 68 20 36 20 65 6c 65 6d | 65 6e 74 73 20 61 6e 64 |h 6 elem|ents and|
|000021c0| 20 79 6f 75 20 77 61 6e | 74 20 74 6f 20 70 6c 6f | you wan|t to plo|
|000021d0| 74 20 73 79 6d 62 6f 6c | 20 39 2e 0a 41 73 20 73 |t symbol| 9..As s|
|000021e0| 74 72 61 6e 67 65 20 61 | 73 20 69 74 20 73 65 65 |trange a|s it see|
|000021f0| 6d 73 20 28 61 74 20 6c | 65 61 73 74 20 74 6f 20 |ms (at l|east to |
|00002200| 43 20 70 72 6f 67 72 61 | 6d 6d 65 72 73 29 20 74 |C progra|mmers) t|
|00002210| 68 65 20 63 6f 6e 73 74 | 61 6e 74 73 20 36 20 61 |he const|ants 6 a|
|00002220| 6e 64 0a 39 20 61 72 65 | 20 70 61 73 73 65 64 20 |nd.9 are| passed |
|00002230| 62 79 20 72 65 66 65 72 | 65 6e 63 65 2e 20 20 20 |by refer|ence.   |
|00002240| 54 68 69 73 20 77 69 6c | 6c 20 61 63 74 75 61 6c |This wil|l actual|
|00002250| 6c 79 20 63 61 6c 6c 20 | 74 68 65 20 66 6f 6c 6c |ly call |the foll|
|00002260| 6f 77 69 6e 67 20 43 0a | 73 74 75 62 20 72 6f 75 |owing C.|stub rou|
|00002270| 74 69 6e 65 20 28 69 6e | 63 6c 75 64 65 64 20 69 |tine (in|cluded i|
|00002280| 6e 20 65 6e 74 69 72 65 | 74 79 29 0a 5c 62 65 67 |n entire|ty).\beg|
|00002290| 69 6e 7b 76 65 72 62 61 | 74 69 6d 7d 0a 23 69 6e |in{verba|tim}.#in|
|000022a0| 63 6c 75 64 65 20 22 70 | 6c 73 74 75 62 73 2e 68 |clude "p|lstubs.h|
|000022b0| 22 0a 0a 76 6f 69 64 20 | 0a 50 4c 50 4f 49 4e 28 |"..void |.PLPOIN(|
|000022c0| 6e 2c 20 78 2c 20 79 2c | 20 63 6f 64 65 29 0a 50 |n, x, y,| code).P|
|000022d0| 4c 49 4e 54 20 2a 6e 2c | 20 2a 63 6f 64 65 3b 0a |LINT *n,| *code;.|
|000022e0| 50 4c 46 4c 54 20 2a 78 | 2c 20 2a 79 3b 0a 7b 0a |PLFLT *x|, *y;.{.|
|000022f0| 20 20 20 20 63 5f 70 6c | 70 6f 69 6e 28 2a 6e 2c |    c_pl|poin(*n,|
|00002300| 20 78 2c 20 79 2c 20 2a | 63 6f 64 65 29 3b 0a 7d | x, y, *|code);.}|
|00002310| 0a 5c 65 6e 64 7b 76 65 | 72 62 61 74 69 6d 7d 0a |.\end{ve|rbatim}.|
|00002320| 41 6c 6c 20 74 68 69 73 | 20 73 74 75 62 20 72 6f |All this| stub ro|
|00002330| 75 74 69 6e 65 20 64 6f | 65 73 20 69 73 20 63 6f |utine do|es is co|
|00002340| 6e 76 65 72 74 20 74 68 | 65 20 6e 75 6d 62 65 72 |nvert th|e number|
|00002350| 20 6f 66 20 70 6f 69 6e | 74 73 20 28 7b 5c 74 74 | of poin|ts ({\tt|
|00002360| 20 2a 6e 7d 20 61 6e 64 | 20 74 68 65 0a 73 79 6d | *n} and| the.sym|
|00002370| 62 6f 6c 20 7b 5c 74 74 | 20 2a 63 6f 64 65 7d 20 |bol {\tt| *code} |
|00002380| 74 6f 20 63 61 6c 6c 20 | 62 79 20 76 61 6c 75 65 |to call |by value|
|00002390| 20 28 69 2e 65 2e 20 20 | 70 75 73 68 65 73 20 74 | (i.e.  |pushes t|
|000023a0| 68 65 69 72 20 76 61 6c | 75 65 20 6f 6e 20 74 68 |heir val|ue on th|
|000023b0| 65 20 73 74 61 63 6b 29 | 0a 61 6e 64 20 74 68 65 |e stack)|.and the|
|000023c0| 6e 20 63 61 6c 6c 73 20 | 74 68 65 20 43 20 70 6c |n calls |the C pl|
|000023d0| 70 6f 69 6e 20 6c 69 62 | 72 61 72 79 20 72 6f 75 |poin lib|rary rou|
|000023e0| 74 69 6e 65 2e 0a 0a 5c | 69 74 65 6d 20 47 65 74 |tine...\|item Get|
|000023f0| 20 6d 61 70 70 69 6e 67 | 20 62 65 74 77 65 65 6e | mapping| between|
|00002400| 20 46 6f 72 74 72 61 6e | 20 61 6e 64 20 43 20 6e | Fortran| and C n|
|00002410| 61 6d 65 73 70 61 63 65 | 20 72 69 67 68 74 20 28 |amespace| right (|
|00002420| 73 79 73 74 65 6d 20 64 | 65 70 65 6e 64 65 6e 74 |system d|ependent|
|00002430| 29 2e 0a 0a 54 68 65 20 | 65 78 74 65 72 6e 61 6c |)...The |external|
|00002440| 20 73 79 6d 62 6f 6c 73 | 20 28 69 2e 65 2e 20 66 | symbols| (i.e. f|
|00002450| 75 6e 63 74 69 6f 6e 20 | 61 6e 64 20 73 75 62 72 |unction |and subr|
|00002460| 6f 75 74 69 6e 65 20 6e | 61 6d 65 73 29 20 61 73 |outine n|ames) as|
|00002470| 20 79 6f 75 20 73 65 65 | 20 74 68 65 6d 0a 69 6e | you see| them.in|
|00002480| 20 79 6f 75 72 20 70 72 | 6f 67 72 61 6d 20 6f 66 | your pr|ogram of|
|00002490| 74 65 6e 20 61 70 70 65 | 61 72 20 64 69 66 66 65 |ten appe|ar diffe|
|000024a0| 72 65 6e 74 6c 79 20 74 | 6f 20 74 68 65 20 6c 69 |rently t|o the li|
|000024b0| 6e 6b 65 72 2e 20 20 46 | 6f 72 20 65 78 61 6d 70 |nker.  F|or examp|
|000024c0| 6c 65 2c 20 74 68 65 0a | 46 6f 72 74 72 61 6e 20 |le, the.|Fortran |
|000024d0| 72 6f 75 74 69 6e 65 20 | 6e 61 6d 65 73 20 6d 61 |routine |names ma|
|000024e0| 79 20 62 65 20 63 6f 6e | 76 65 72 74 65 64 20 74 |y be con|verted t|
|000024f0| 6f 20 75 70 70 65 72 63 | 61 73 65 20 6f 72 20 6c |o upperc|ase or l|
|00002500| 6f 77 65 72 63 61 73 65 | 2c 20 61 6e 64 2f 6f 72 |owercase|, and/or|
|00002510| 0a 68 61 76 65 20 61 6e | 20 75 6e 64 65 72 73 63 |.have an| undersc|
|00002520| 6f 72 65 20 61 70 70 65 | 6e 64 65 64 20 6f 72 20 |ore appe|nded or |
|00002530| 70 72 65 70 65 6e 64 65 | 64 2e 20 20 54 68 69 73 |prepende|d.  This|
|00002540| 20 74 72 61 6e 73 6c 61 | 74 69 6f 6e 20 69 73 20 | transla|tion is |
|00002550| 68 61 6e 64 6c 65 64 0a | 65 6e 74 69 72 65 6c 79 |handled.|entirely|
|00002560| 20 76 69 61 20 72 65 64 | 65 66 69 6e 69 74 69 6f | via red|efinitio|
|00002570| 6e 20 6f 66 20 74 68 65 | 20 73 74 75 62 20 72 6f |n of the| stub ro|
|00002580| 75 74 69 6e 65 20 6e 61 | 6d 65 73 2c 20 77 68 69 |utine na|mes, whi|
|00002590| 63 68 20 61 72 65 20 6d | 61 63 72 6f 73 2e 0a 54 |ch are m|acros..T|
|000025a0| 68 65 72 65 20 61 72 65 | 20 73 65 76 65 72 61 6c |here are| several|
|000025b0| 20 6f 70 74 69 6f 6e 73 | 20 66 6f 72 20 63 6f 6d | options| for com|
|000025c0| 70 69 6c 69 6e 67 20 50 | 4c 70 6c 6f 74 20 74 68 |piling P|Lplot th|
|000025d0| 61 74 20 73 69 6d 70 6c | 69 66 79 20 67 65 74 74 |at simpl|ify gett|
|000025e0| 69 6e 67 20 74 68 65 0a | 6e 61 6d 65 20 74 72 61 |ing the.|name tra|
|000025f0| 6e 73 6c 61 74 69 6f 6e | 20 72 69 67 68 74 20 28 |nslation| right (|
|00002600| 73 65 65 20 41 70 70 65 | 6e 64 69 78 20 5c 72 65 |see Appe|ndix \re|
|00002610| 66 7b 61 70 3a 73 79 73 | 7d 20 66 6f 72 20 6d 6f |f{ap:sys|} for mo|
|00002620| 72 65 20 69 6e 66 6f 29 | 2e 20 20 49 6e 20 61 6e |re info)|.  In an|
|00002630| 79 0a 63 61 73 65 2c 20 | 6f 6e 63 65 20 74 68 65 |y.case, |once the|
|00002640| 20 6e 61 6d 65 20 74 72 | 61 6e 73 6c 61 74 69 6f | name tr|anslatio|
|00002650| 6e 20 69 73 20 65 73 74 | 61 62 6c 69 73 68 65 64 |n is est|ablished|
|00002660| 20 64 75 72 69 6e 67 20 | 69 6e 73 74 61 6c 6c 61 | during |installa|
|00002670| 74 69 6f 6e 2c 20 6e 61 | 6d 65 0a 74 72 61 6e 73 |tion, na|me.trans|
|00002680| 6c 61 74 69 6f 6e 20 69 | 73 20 63 6f 6d 70 6c 65 |lation i|s comple|
|00002690| 74 65 6c 79 20 74 72 61 | 6e 73 70 61 72 65 6e 74 |tely tra|nsparent|
|000026a0| 20 74 6f 20 74 68 65 20 | 75 73 65 72 2e 0a 0a 5c | to the |user...\|
|000026b0| 69 74 65 6d 20 54 72 61 | 6e 73 6c 61 74 69 6f 6e |item Tra|nslation|
|000026c0| 20 6f 66 20 63 68 61 72 | 61 63 74 65 72 20 73 74 | of char|acter st|
|000026d0| 72 69 6e 67 20 66 6f 72 | 6d 61 74 20 66 72 6f 6d |ring for|mat from|
|000026e0| 20 46 6f 72 74 72 61 6e | 20 74 6f 20 43 2e 0a 0a | Fortran| to C...|
|000026f0| 46 6f 72 74 72 61 6e 20 | 63 68 61 72 61 63 74 65 |Fortran |characte|
|00002700| 72 20 73 74 72 69 6e 67 | 73 20 61 72 65 20 70 61 |r string|s are pa|
|00002710| 73 73 65 64 20 64 69 66 | 66 65 72 65 6e 74 6c 79 |ssed dif|ferently|
|00002720| 20 74 68 61 6e 20 6f 74 | 68 65 72 20 71 75 61 6e | than ot|her quan|
|00002730| 74 69 74 69 65 73 2c 20 | 69 6e 0a 74 68 61 74 20 |tities, |in.that |
|00002740| 61 20 73 74 72 69 6e 67 | 20 64 65 73 63 72 69 70 |a string| descrip|
|00002750| 74 6f 72 20 69 73 20 70 | 75 73 68 65 64 20 6f 6e |tor is p|ushed on|
|00002760| 20 74 68 65 20 73 74 61 | 63 6b 20 61 6c 6f 6e 67 | the sta|ck along|
|00002770| 20 77 69 74 68 20 74 68 | 65 20 73 74 72 69 6e 67 | with th|e string|
|00002780| 0a 61 64 64 72 65 73 73 | 2e 20 20 43 20 64 6f 65 |.address|.  C doe|
|00002790| 73 6e 27 74 20 77 61 6e | 74 20 74 68 65 20 64 65 |sn't wan|t the de|
|000027a0| 73 63 72 69 70 74 6f 72 | 2c 20 69 74 20 77 61 6e |scriptor|, it wan|
|000027b0| 74 73 20 61 20 4e 55 4c | 4c 20 74 65 72 6d 69 6e |ts a NUL|L termin|
|000027c0| 61 74 65 64 20 73 74 72 | 69 6e 67 2e 0a 46 6f 72 |ated str|ing..For|
|000027d0| 20 72 6f 75 74 69 6e 65 | 73 20 74 68 61 74 20 68 | routine|s that h|
|000027e0| 61 6e 64 6c 65 20 73 74 | 72 69 6e 67 73 20 74 77 |andle st|rings tw|
|000027f0| 6f 20 73 74 75 62 20 72 | 6f 75 74 69 6e 65 73 20 |o stub r|outines |
|00002800| 61 72 65 20 6e 65 63 65 | 73 73 61 72 79 2c 20 6f |are nece|ssary, o|
|00002810| 6e 65 0a 77 72 69 74 74 | 65 6e 20 69 6e 20 46 6f |ne.writt|en in Fo|
|00002820| 72 74 72 61 6e 20 61 6e | 64 20 6f 6e 65 20 77 72 |rtran an|d one wr|
|00002830| 69 74 74 65 6e 20 69 6e | 20 43 2e 20 20 59 6f 75 |itten in| C.  You|
|00002840| 72 20 46 6f 72 74 72 61 | 6e 20 70 72 6f 67 72 61 |r Fortra|n progra|
|00002850| 6d 20 63 61 6c 6c 73 20 | 74 68 65 0a 46 6f 72 74 |m calls |the.Fort|
|00002860| 72 61 6e 20 73 74 75 62 | 20 72 6f 75 74 69 6e 65 |ran stub| routine|
|00002870| 20 66 69 72 73 74 2e 20 | 20 54 68 69 73 20 73 74 | first. | This st|
|00002880| 75 62 20 63 6f 6e 76 65 | 72 74 73 20 74 68 65 20 |ub conve|rts the |
|00002890| 63 68 61 72 61 63 74 65 | 72 20 73 74 72 69 6e 67 |characte|r string|
|000028a0| 20 74 6f 20 61 0a 6e 75 | 6c 6c 20 74 65 72 6d 69 | to a.nu|ll termi|
|000028b0| 6e 61 74 65 64 20 69 6e | 74 65 67 65 72 20 61 72 |nated in|teger ar|
|000028c0| 72 61 79 20 61 6e 64 20 | 74 68 65 6e 20 63 61 6c |ray and |then cal|
|000028d0| 6c 73 20 74 68 65 20 43 | 20 73 74 75 62 20 72 6f |ls the C| stub ro|
|000028e0| 75 74 69 6e 65 2e 20 20 | 54 68 65 20 43 0a 73 74 |utine.  |The C.st|
|000028f0| 75 62 20 72 6f 75 74 69 | 6e 65 20 63 6f 6e 76 65 |ub routi|ne conve|
|00002900| 72 74 73 20 74 68 65 20 | 69 6e 74 65 67 65 72 20 |rts the |integer |
|00002910| 61 72 72 61 79 20 28 74 | 79 70 65 20 7b 5c 74 74 |array (t|ype {\tt|
|00002920| 20 6c 6f 6e 67 7d 29 20 | 74 6f 20 74 68 65 20 75 | long}) |to the u|
|00002930| 73 75 61 6c 20 43 0a 73 | 74 72 69 6e 67 20 72 65 |sual C.s|tring re|
|00002940| 70 72 65 73 65 6e 74 61 | 74 69 6f 6e 20 28 77 68 |presenta|tion (wh|
|00002950| 69 63 68 20 6d 61 79 20 | 62 65 20 64 69 66 66 65 |ich may |be diffe|
|00002960| 72 65 6e 74 2c 20 64 65 | 70 65 6e 64 69 6e 67 20 |rent, de|pending |
|00002970| 6f 6e 20 77 68 65 74 68 | 65 72 20 79 6f 75 72 0a |on wheth|er your.|
|00002980| 6d 61 63 68 69 6e 65 20 | 75 73 65 73 20 61 20 62 |machine |uses a b|
|00002990| 69 67 20 65 6e 64 69 61 | 6e 20 6f 72 20 6c 69 74 |ig endia|n or lit|
|000029a0| 74 6c 65 20 65 6e 64 69 | 61 6e 20 62 79 74 65 20 |tle endi|an byte |
|000029b0| 6f 72 64 65 72 69 6e 67 | 3b 20 69 6e 20 61 6e 79 |ordering|; in any|
|000029c0| 20 63 61 73 65 20 74 68 | 65 0a 77 61 79 20 69 74 | case th|e.way it|
|000029d0| 20 69 73 20 64 6f 6e 65 | 20 69 6e 20 50 4c 70 6c | is done| in PLpl|
|000029e0| 6f 74 20 69 73 20 70 6f | 72 74 61 62 6c 65 29 2e |ot is po|rtable).|
|000029f0| 20 20 53 65 65 20 74 68 | 65 20 7b 5c 74 74 20 70 |  See th|e {\tt p|
|00002a00| 6c 6d 74 65 78 7d 20 73 | 74 75 62 73 20 66 6f 72 |lmtex} s|tubs for|
|00002a10| 20 61 6e 0a 65 78 61 6d | 70 6c 65 20 6f 66 20 74 | an.exam|ple of t|
|00002a20| 68 69 73 2e 20 0a 0a 4e | 6f 74 65 20 74 68 61 74 |his. ..N|ote that|
|00002a30| 20 74 68 65 20 70 6f 72 | 74 69 6f 6e 20 6f 66 20 | the por|tion of |
|00002a40| 61 20 46 6f 72 74 72 61 | 6e 20 63 68 61 72 61 63 |a Fortra|n charac|
|00002a50| 74 65 72 20 73 74 72 69 | 6e 67 20 74 68 61 74 20 |ter stri|ng that |
|00002a60| 65 78 63 65 65 64 73 20 | 32 39 39 0a 63 68 61 72 |exceeds |299.char|
|00002a70| 61 63 74 65 72 73 20 77 | 69 6c 6c 20 6e 6f 74 20 |acters w|ill not |
|00002a80| 62 65 20 70 6c 6f 74 74 | 65 64 20 62 79 20 74 68 |be plott|ed by th|
|00002a90| 65 20 74 65 78 74 20 72 | 6f 75 74 69 6e 65 73 20 |e text r|outines |
|00002aa0| 28 7b 5c 74 74 20 70 6c | 6d 74 65 78 7d 20 61 6e |({\tt pl|mtex} an|
|00002ab0| 64 20 7b 5c 74 74 0a 70 | 6c 70 74 65 78 7d 29 2e |d {\tt.p|lptex}).|
|00002ac0| 20 0a 0a 5c 69 74 65 6d | 20 4d 75 6c 74 69 64 69 | ..\item| Multidi|
|00002ad0| 6d 65 6e 73 69 6f 6e 61 | 6c 20 61 72 72 61 79 20 |mensiona|l array |
|00002ae0| 61 72 67 75 6d 65 6e 74 | 73 20 61 72 65 20 63 68 |argument|s are ch|
|00002af0| 61 6e 67 65 64 20 66 72 | 6f 6d 20 72 6f 77 2d 64 |anged fr|om row-d|
|00002b00| 6f 6d 69 6e 61 6e 74 20 | 74 6f 0a 63 6f 6c 75 6d |ominant |to.colum|
|00002b10| 6e 2d 64 6f 6d 69 6e 61 | 6e 74 20 6f 72 64 65 72 |n-domina|nt order|
|00002b20| 69 6e 67 20 74 68 72 6f | 75 67 68 20 75 73 65 20 |ing thro|ugh use |
|00002b30| 6f 66 20 61 20 74 65 6d | 70 6f 72 61 72 79 20 61 |of a tem|porary a|
|00002b40| 72 72 61 79 2e 0a 0a 49 | 6e 20 46 6f 72 74 72 61 |rray...I|n Fortra|
|00002b50| 6e 2c 20 61 72 72 61 79 | 73 20 61 72 65 20 61 6c |n, array|s are al|
|00002b60| 77 61 79 73 20 73 74 6f | 72 65 64 20 73 6f 20 74 |ways sto|red so t|
|00002b70| 68 61 74 20 74 68 65 20 | 66 69 72 73 74 20 69 6e |hat the |first in|
|00002b80| 64 65 78 20 69 6e 63 72 | 65 61 73 65 73 20 6d 6f |dex incr|eases mo|
|00002b90| 73 74 0a 72 61 70 69 64 | 6c 79 20 61 73 20 6f 6e |st.rapid|ly as on|
|00002ba0| 65 20 73 74 65 70 73 20 | 74 68 72 6f 75 67 68 20 |e steps |through |
|00002bb0| 6d 65 6d 6f 72 79 2e 20 | 20 54 68 69 73 20 69 73 |memory. | This is|
|00002bc0| 20 63 61 6c 6c 65 64 20 | 60 60 72 6f 77 2d 64 6f | called |``row-do|
|00002bd0| 6d 69 6e 61 6e 74 27 27 | 0a 73 74 6f 72 61 67 65 |minant''|.storage|
|00002be0| 2e 20 20 49 6e 20 43 2c | 20 6f 6e 20 74 68 65 20 |.  In C,| on the |
|00002bf0| 6f 74 68 65 72 20 68 61 | 6e 64 2c 20 74 68 65 20 |other ha|nd, the |
|00002c00| 66 69 72 73 74 20 69 6e | 64 65 78 20 69 6e 63 72 |first in|dex incr|
|00002c10| 65 61 73 65 73 20 7b 5c | 65 6d 20 6c 65 61 73 74 |eases {\|em least|
|00002c20| 5c 2f 7d 0a 72 61 70 69 | 64 6c 79 2c 20 69 2e 65 |\/}.rapi|dly, i.e|
|00002c30| 2e 20 60 60 63 6f 6c 75 | 6d 6e 2d 64 6f 6d 69 6e |. ``colu|mn-domin|
|00002c40| 61 6e 74 27 27 20 6f 72 | 64 65 72 69 6e 67 2e 20 |ant'' or|dering. |
|00002c50| 20 54 68 75 73 2c 20 74 | 77 6f 20 64 69 6d 65 6e | Thus, t|wo dimen|
|00002c60| 73 69 6f 6e 61 6c 20 61 | 72 72 61 79 73 0a 28 65 |sional a|rrays.(e|
|00002c70| 2e 67 2e 20 20 61 73 20 | 70 61 73 73 65 64 20 74 |.g.  as |passed t|
|00002c80| 6f 20 74 68 65 20 63 6f | 6e 74 6f 75 72 20 6f 72 |o the co|ntour or|
|00002c90| 20 73 75 72 66 61 63 65 | 20 70 6c 6f 74 74 69 6e | surface| plottin|
|00002ca0| 67 20 72 6f 75 74 69 6e | 65 73 29 20 70 61 73 73 |g routin|es) pass|
|00002cb0| 65 64 20 69 6e 74 6f 0a | 50 4c 70 6c 6f 74 20 6d |ed into.|PLplot m|
|00002cc0| 75 73 74 20 62 65 20 74 | 72 61 6e 73 70 6f 73 65 |ust be t|ranspose|
|00002cd0| 64 20 69 6e 20 6f 72 64 | 65 72 20 74 6f 20 67 65 |d in ord|er to ge|
|00002ce0| 74 20 74 68 65 20 70 72 | 6f 70 65 72 20 74 77 6f |t the pr|oper two|
|00002cf0| 2d 64 69 6d 65 6e 73 69 | 6f 6e 61 6c 0a 72 65 6c |-dimensi|onal.rel|
|00002d00| 61 74 69 6f 6e 73 68 69 | 70 20 74 6f 20 74 68 65 |ationshi|p to the|
|00002d10| 20 77 6f 72 6c 64 20 63 | 6f 6f 72 64 69 6e 61 74 | world c|oordinat|
|00002d20| 65 73 2e 20 20 54 68 69 | 73 20 69 73 20 68 61 6e |es.  Thi|s is han|
|00002d30| 64 6c 65 64 20 69 6e 20 | 74 68 65 20 43 20 73 74 |dled in |the C st|
|00002d40| 75 62 0a 72 6f 75 74 69 | 6e 65 73 20 62 79 20 64 |ub.routi|nes by d|
|00002d50| 79 6e 61 6d 69 63 20 6d | 65 6d 6f 72 79 20 61 6c |ynamic m|emory al|
|00002d60| 6c 6f 63 61 74 69 6f 6e | 20 6f 66 20 61 20 74 65 |location| of a te|
|00002d70| 6d 70 6f 72 61 72 79 20 | 61 72 72 61 79 2e 20 20 |mporary |array.  |
|00002d80| 54 68 69 73 20 69 73 20 | 74 68 65 6e 20 73 65 74 |This is |then set|
|00002d90| 0a 65 71 75 61 6c 20 74 | 6f 20 74 68 65 20 74 72 |.equal t|o the tr|
|00002da0| 61 6e 73 70 6f 73 65 20 | 6f 66 20 74 68 65 20 70 |anspose |of the p|
|00002db0| 61 73 73 65 64 20 69 6e | 20 61 72 72 61 79 20 61 |assed in| array a|
|00002dc0| 6e 64 20 70 61 73 73 65 | 64 20 74 6f 20 74 68 65 |nd passe|d to the|
|00002dd0| 20 61 70 70 72 6f 70 72 | 69 61 74 65 0a 50 4c 70 | appropr|iate.PLp|
|00002de0| 6c 6f 74 20 72 6f 75 74 | 69 6e 65 2e 20 20 54 68 |lot rout|ine.  Th|
|00002df0| 65 20 6f 76 65 72 68 65 | 61 64 20 61 73 73 6f 63 |e overhe|ad assoc|
|00002e00| 69 61 74 65 64 20 77 69 | 74 68 20 74 68 69 73 20 |iated wi|th this |
|00002e10| 69 73 20 6e 6f 72 6d 61 | 6c 6c 79 20 6e 6f 74 20 |is norma|lly not |
|00002e20| 69 6d 70 6f 72 74 61 6e | 74 0a 62 75 74 20 63 6f |importan|t.but co|
|00002e30| 75 6c 64 20 62 65 20 61 | 20 66 61 63 74 6f 72 20 |uld be a| factor |
|00002e40| 69 66 20 79 6f 75 20 61 | 72 65 20 75 73 69 6e 67 |if you a|re using|
|00002e50| 20 76 65 72 79 20 6c 61 | 72 67 65 20 32 64 20 61 | very la|rge 2d a|
|00002e60| 72 72 61 79 73 2e 0a 5c | 65 6e 64 7b 65 6e 75 6d |rrays..\|end{enum|
|00002e70| 65 72 61 74 65 7d 0a 0a | 54 68 69 73 20 61 6c 6c |erate}..|This all|
|00002e80| 20 73 65 65 6d 73 20 61 | 20 6c 69 74 74 6c 65 20 | seems a| little |
|00002e90| 6d 65 73 73 79 2c 20 62 | 75 74 20 69 73 20 76 65 |messy, b|ut is ve|
|00002ea0| 72 79 20 75 73 65 72 20 | 66 72 69 65 6e 64 6c 79 |ry user |friendly|
|00002eb0| 2e 20 20 46 6f 72 74 72 | 61 6e 20 61 6e 64 20 43 |.  Fortr|an and C|
|00002ec0| 0a 70 72 6f 67 72 61 6d | 6d 65 72 73 20 63 61 6e |.program|mers can|
|00002ed0| 20 75 73 65 20 74 68 65 | 20 73 61 6d 65 20 62 61 | use the| same ba|
|00002ee0| 73 69 63 20 69 6e 74 65 | 72 66 61 63 65 20 74 6f |sic inte|rface to|
|00002ef0| 20 74 68 65 20 6c 69 62 | 72 61 72 79 2c 20 77 68 | the lib|rary, wh|
|00002f00| 69 63 68 20 69 73 20 61 | 0a 70 6f 77 65 72 66 75 |ich is a|.powerfu|
|00002f10| 6c 20 70 6c 75 73 20 66 | 6f 72 20 74 68 69 73 20 |l plus f|or this |
|00002f20| 6d 65 74 68 6f 64 2e 20 | 20 54 68 65 20 66 61 63 |method. | The fac|
|00002f30| 74 20 74 68 61 74 20 73 | 74 75 62 20 72 6f 75 74 |t that s|tub rout|
|00002f40| 69 6e 65 73 20 61 72 65 | 20 62 65 69 6e 67 20 75 |ines are| being u|
|00002f50| 73 65 64 0a 69 73 20 63 | 6f 6d 70 6c 65 74 65 6c |sed.is c|ompletel|
|00002f60| 79 20 74 72 61 6e 73 70 | 61 72 65 6e 74 20 74 6f |y transp|arent to|
|00002f70| 20 74 68 65 20 46 6f 72 | 74 72 61 6e 20 70 72 6f | the For|tran pro|
|00002f80| 67 72 61 6d 6d 65 72 2e | 0a 0a 46 6f 72 20 6d 6f |grammer.|..For mo|
|00002f90| 72 65 20 69 6e 66 6f 72 | 6d 61 74 69 6f 6e 20 6f |re infor|mation o|
|00002fa0| 6e 20 63 61 6c 6c 69 6e | 67 20 50 4c 70 6c 6f 74 |n callin|g PLplot|
|00002fb0| 20 66 72 6f 6d 20 46 6f | 72 74 72 61 6e 2c 20 70 | from Fo|rtran, p|
|00002fc0| 6c 65 61 73 65 20 73 65 | 65 20 74 68 65 20 31 33 |lease se|e the 13|
|00002fd0| 0a 65 78 61 6d 70 6c 65 | 20 46 6f 72 74 72 61 6e |.example| Fortran|
|00002fe0| 20 70 72 6f 67 72 61 6d | 73 20 28 7b 5c 74 74 20 | program|s ({\tt |
|00002ff0| 78 30 31 66 2e 66 7d 20 | 74 68 72 6f 75 67 68 20 |x01f.f} |through |
|00003000| 7b 5c 74 74 20 78 31 33 | 66 2e 66 7d 29 20 64 69 |{\tt x13|f.f}) di|
|00003010| 73 74 72 69 62 75 74 65 | 64 0a 77 69 74 68 20 50 |stribute|d.with P|
|00003020| 4c 70 6c 6f 74 2e 0a    |                         |Lplot.. |        |
+--------+-------------------------+-------------------------+--------+--------+